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TARH Spring 源码 ， 方 便 读 者 根据 业务 需求 进行 更 改 或 扩展 
所 有 知识 点 秉承 由 浅 信 深 、 由 易 到 难 的 讲解 架构 
采用 抽 丝 剥 ROAR 来 阐述 复杂 的 逻辑 ， 降低 理解 难度 
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All 2 
资源 与 支持 
第 1 部 分 核心 实现 


第 1 章 Spring 整体 架构 和 环境 搭建 
1.1 Spring 的 整体 架构 

1.2 环境 搭建 

1.2.1 源码 链接 获取 

1.2.2 源码 下 载 及 IDEA 导 入 

1.3 cglib 和 objenesis 的 编译 错误 解 ; 
1.3.1 问题 友 现 及 原因 

1.3.2 器 题解 ; 

1.4 AspectJ 编 译 问 题解 ; 
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内 容 所 要 


本 书 从 核心 实现 、 企 业 应 用 和 Spring Boot 这 3 
个 方面 ， 由 浅 入 深 、 由 易 到 难 地 对 Spring 源码 展开 
了 系统 的 讲解 ， 包 括 Spring 整体 架构 和 环境 搭建 、 
容 右 的 基本 实现 、 上 默认 标 签 的 解析 、 目 定义 标签 的 
解析 、bean 的 加 载 、 容 器 的 功能 扩展 、AOP、 数 据 
库 连 接 JDBC、 整 合 MyBatis、 事 务 、SpringMVC、 
远程 服务 、Spring 消 息 、Spring Boot 体 系 原 理 等 内 
容 。 

本 书 不 仅 介绍 了 使 用 Spring 框架 开发 项 目 必 须 
掌握 的 核心 概念 ， 还 指导 读者 使 用 Spring 框 染 编写 
企业 级 应 用 ， 并 针对 在 编写 代码 的 过 程 中 如 何 优 化 
代码 、 如 何 使 得 代码 高 效 给 出 了 切实 可 行 的 建议 ， 
从 而 帮助 读者 全 面 提升 实战 能 力 。 


本 书 语言 简洁 ， 示 例 丰 富 ， 可 帮助 读者 迅速 党 
握 使 用 Spring 进 行 开发 所 需 的 各 种 技能 。 本 书 适合 
于 已 具有 一 定 Java 编 程 基础 的 读者 ， 以 及 在 Java 平 
侣 下 进行 各 类 软件 开发 的 开发 人 员 、 测 试 人 员 等 。 
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厚 佳 ， 计 算 机 专业 硕士 学 位 ， 曾 发 表 过 多 篇 论 
文 并 先后 被 EI、SCI 收 录 ; 2008 年 辽宁 省 教育 厅 科 
技 计 划 项 目 研 究 人 之 一 : 长 期 奋斗 于 J2EE 领 域 ， 
2013 年 入 职 阿 里 巴巴 ， 目 前 担任 业务 中 间 件 软件 架 
构 师 ， 一 直 专 注 于 中 间 件 领域 ， 拥 有 6 项 技术 专 
利 ， 擅 长 系统 的 性 能 优化 ;热衷 于 研究 各 种 优秀 的 
开源 代码 并 从 中 进行 总 结 ， 从 而 实现 个 人 技能 的 提 
高 ， 尤 其 对 Spring、Hibernate、MYyBatis、JMS、 
Tomcat 等 源码 有 着 深刻 的 理解 和 认识 。 





源 代码 的 重要 性 


Java 开 发 人 员 都 知道 ， 阅 读 源 人 码 是 非常 好 的 学 
习 方 式 ， 在 我 们 日 常 工作 中 或 多 或 少 都 会 接触 一 些 
FURNES, beanie iy FAY Struts. Hibernate. 
Spring， 这 些 源码 的 普及 与 应 用 程度 远 远 超过 我 们 
的 想象 ， 正 因为 很 多 人 使 用 ， 也 在 推动 着 源码 不 断 
地 完善 。 这 些 优秀 的 源码 中 有 着 多 年 积淀 下 来 的 精 
华 ， 这 些 精 华 是 非常 值得 我 们 学 习 的 ， 不 管 我 们 当 
前 是 什么 水 平 ， 通 过 反复 阅读 源码 ， 能 力 都 会 有 所 
提升 ， 小 到 对 源码 所 提供 的 功能 上 的 使 用 更 加 玖 
练 ， 大 到 使 我 们 的 程序 设计 更 加 完美 优秀 。 但 是 ， 
纵 观 我 们 里边 的 人 ， 能 够 做 到 通读 源码 的 真 的 是 少 
之 又 少 ， 究 其 原因 ， 不 外 平 以 下 几 扣 。 


。 阅读 源码 绝对 算得 上 是 一 件 颖 时 费力 的 工作 ， 
需要 读者 耗费 大 量 的 时 间 去 完成 。 而 作为 开 友 
人 员 ， 毕 葛 精 力 有 限 ， 实 在 没 办 法 拿 出 太 多 的 
时 间 放 在 源码 的 阅读 上 。 

。 源 码 的 复杂 性 。 任 何 一 球 源 人 码 经 历 了 多 年 的 友 
































展 与 提炼 ， 其 复杂 程度 可 想 而 知 。 当 我 们 阅读 
源码 的 时 候 ， 大 家 都 知道 需要 通过 工具 来 跟踪 
代码 的 运行 ， 进 而 去 分 析 程 序 。 但 是 ， 当 代码 
过 于 复杂 ， 环 环 相 扣 统 来 绕 去 的 时 候 ， 跟 进 了 
几 十 个 甚至 几 百 个 函数 后 ， 这 时 我 们 已 经 不 知 
道 自己 所 处 的 位 置 了 ， 不 得 不 再 重 来 ， 但 是 一 
次 又 一 次 地 ， 最 终 发 现 自己 根本 无 法 轰 驭 它 ， 
不 得 不 放弃 。 

。 有 些 源码 发 展 多 年 ， 会 迪 到 各 种 各 样 的 问题 ， 
并 对 问题 进行 了 解决 ， 而 其 中 有 些 问 题 对 于 我 
们 来 说 甚至 可 以 用 莫名 其 妙 来 修饰 ， 有 了 时候 根 
本 想 不 出 会 在 什么 情况 下 发 生 。 我 们 查阅 各 种 
资料 ， 查 询 无 果 后 ， 会 失去 耐心 ， 最 终 放弃 。 


无 论 基于 什么 样 的 原因 ， 放 弃 阅 读 源 码 始终 不 
是 一 个 明智 的 选择 ， 因 为 你 失去 了 一 个 跟 大 师 学 习 
的 机 会 。 而 且 ， 当 你 读 过 几 个 源码 之 后 右 会 友 现 ， 
它们 的 思想 以 及 实现 方式 是 相 明 的 。 这 束 是 开源 的 
好 处 。 随 看 各 种 开源 软件 的 发 展 ， 各 家 都 会 融合 列 
家 优 郁 之 处 来 不 断 完 赤 自 己 ， 这 样 ， 到 最 后 的 结果 
就 是 所 有 的 开源 软件 从 设计 上 或 者 实现 上 都 会 变 得 
AA, tall ce bb Sa PRE TERT CFS UNS J H 
Ad» MRS, bd BR RE aS A RRK ER. 


以 我 为 例 ，Spring 是 我 阅读 的 第 一 个 源码 ， 几 



































但 是 当 我 谈 完 Spring 后 再 去 谈 MyBatis， 只 用 了 两 周 
时 间 。 当 然 ， 暂 且 不 论 它 们 的 复杂 程度 不 同 ， 至 少 
我 在 阅读 的 时 候 发 现 了 很 多 相通 的 东西 。 当 你 第 一 
次 阅读 的 时 候 ， 重 点 一 定 是 在 源码 的 理解 上 ， 但 

是 ， 当 谈 完 第 一 个 圣 码 再 去 该 下 一 个 的 时 候 ， 和 你 目 
然而 然 地 会 带 厦 批判 或 者 说 挑剔 的 眼光 去 阅读 : 为 
什么 这 个 功能 在 我 之 前 看 的 源码 中 是 那样 实现 的 ， 

而 在 这 里 会 是 这 样 实 现 的 ? 这 其 中 的 道理 在 哪里 ， 

哪 种 实现 方式 更 优秀 呢 ? 而 通过 这 样 的 对 比 及 探 

索 ， 你 会 发 现 ， 目 己 的 进步 快 得 难以 想象 。 


我 们 已 经 有 些 纠结 了， 既然 阅读 源码 有 那么 多 
的 好 处 ， 但 是 很 多 读者 却 因为 时 间或 者 能 力 的 问题 
而 不 得 不 放弃 ， 岂 不 是 太 可 惜 ? 为 了 解决 这 个 问 
题 ， 我 撰写 了 本 书 ， 总 结 了 目 己 的 研究 心得 和 实际 
项 目 经 验 ， 和 希望 能 对 正在 Spring 道路 上 摸索 的 同仁 
提供 一 些 帮 助 。 
































AS PERF S 


AS SEE MOT ARCHI EAS BUTS. BE 
部 会 捉 供 具有 代表 性 的 实例 ， 并 以 此 为 基础 进行 功 
能 实现 的 分 析 ， 而 不 是 采取 开 扁 驶 讲解 容 硕 怎么 实 
现 、AOP 怎 么 实现 之 闫 的 写法 。 在 描述 的 过 程 中 ， 
本 书 尽 可 能 地 把 问题 分 解 ， 使 用 重洋 签 的 方式 一 层 





一 层 地 将 逻辑 摘 述 清楚 ， 帮 助 读者 由 浅 入 深 地 进行 
学 习 ， 并 把 其 中 的 难点 和 问题 各 个 击破 ， 而 不 是 企 
图 一 下 让 读者 理解 一 个 复杂 的 逻辑 。 


在 阅读 源码 的 过 程 中 ， 难 免 会 遇 到 各 种 各 样 的 
生 售 功 能 ， 这 些 功 能 在 特定 的 场合 会 非常 有 用 ， 但 
是 可 能 多 数 情况 下 并 不 是 很 第 用 ， 其 至 部 伍 阅 不 到 
相关 的 使 用 资料 。 本 书 中 重点 针对 这 种 情况 提供 了 
相应 的 实用 示例 ， 让 读者 更 加 全 面 地 了 解 Spring 所 
2 Ue 使 读者 对 代 人 码 能 知 其 然 还 知 其 所 以 




















本 书 按照 每 章 所 提供 的 示例 跟踪 Spring 源码 的 
流程 ， 尽 可 能 保证 代码 的 连续 性 ， 确 保 谈 者 的 思维 
不 被 打 乱 ， 让 读者 看 到 Spring 的 执行 流程 ， 尽 量 使 
读者 在 阅读 完 本 书后 ， 即 使 在 不 阅读 Spring 源 码 的 
情况 下 也 可 以 对 Spring 产 人 码 进 行 优 化 ， 其 至 通过 扩 
展 源 码 来 满足 业务 需求 (这 对 开发 人 员 来 说 是 一 个 
很 高 的 要 求 ) 。 本 书 硕 望 能 帮助 谈 者 全 面 提 升 实战 


能 力 。 











本 书 分 为 3 部 分 : 核心 实现 、 企 业 应 用 和 Spring 


第 1 部 分 ， 核 心 实现 (第 1 一 7 章 ) : 是 Spring 功 
能 的 基础 ， 也 是 企业 应 用 部 分 的 基础 ， 主 要 对 
容器 以 及 AOP 功 能 实现 做 了 其 体 的 分 机 。 如 有 条 
读者 之 前 没有 接触 过 Spring 源 代码 ， 建 议 认 真 阅 
该 这 个 部 分 ， 人 否则 阅读 企业 应 用 部 分 时 会 比较 
nz. 

第 2 部 分 ， 企 业 应 用 《第 8 一 13 章 ) : 在 核心 实 
现 部 分 的 基础 上 围 经 企业 应 用 第 用 的 模块 进行 
讨论 ， 这 些 模块 包括 Spring 整合 JDBC、Spring 整 
合 MyBatis、 事 务 、SpringMVC、 远 程 服 务 、 
Spring ERS, SEEDA EH AFRE 
更 加 高 效 地 使 用 Spring。 

第 3 部 分 ，Spring Boot (第 14 半 ) : 对 近期 流行 
的 Spring Boot 的 体系 原理 进行 分 机 ， 和 剥离 其 神 
秘 的 面纱 。Spring Boot 作 为 Spring 外 的 一 个 独立 
分 文 ， 可 以 说 将 Spring 的 扩展 能 力 应 用 得 出 神 入 
化 ， 仔 细 研 读 后 一 定 会 受益 菲 浅 。 


本 书 适用 的 Spring 版 本 

















截至 完稿 ，Spring 已 经 发 布 了 5.x 版 本 。 本 书 所 
讨论 的 内 容 属于 Spring 的 基础 和 种 用 的 功能 ， 这 些 
功能 部 经 过 长 时 间 、 大 量 用 户 的 验证 ， 已 经 非常 成 
A, DLW AY REPEAT BC), BI Spring fa k SE 3r 
到 10.x， 相 信 这 些 内 容 也 不 会 过 时 ， 因 此 值得 读者 





去 阅读 。 而 且 从 目前 Spring 的 功能 规划 来 看 ， 本 书 
所 涉及 的 内 容 并 不 在 Spring 未 来 改动 的 范围 内 ， 
此 在 未 来 的 很 长 一 段 时 间 内 本 书 都 不 会 过 时 。 
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创作 本 书 的 过 程 是 痛 苗 的 ， 持 续 时 间 也 远 远 超 
乎 了 我 的 想象 ， 而 且 本 以 为 和 目 己 对 Spring 已 经 非常 
熟悉 ， 没 想到 在 写作 的 过 程 中 还 是 会 遇 到 各 种 各 样 
的 问题 ， 但 是 我 很 和 位 运 我 能 坚持 下 来 。 在 这 里 我 首 
先 应 该 感谢 爸爸 妈妈 ， 虽 然 他 们 不 知道 儿子 在 忙 忙 
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同时 还 要 感谢 我 的 妻子 ， 在 刚刚 生 下 宝宝 后 没有 过 
哺乳 期 的 情况 下 也 一 直 默 默 文 持 我 ， 没 有 因为 缺少 
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亮 、 刘 阳 、 鞭 思 文 、 金 施 源 等 在 本 书 编写 过 程 中 给 
予 的 文 持 与 帮助 。 
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本 书 在 编写 过 程 中 ， 以 “ 够 用 就 好 ?为 原则 ， 尽 
量 敌 盖 到 Spring 开发 的 种 用 功能 。 所 有 观点 都 出 自 
作者 的 个 人 见解 ， 朴 漏 、 错 误 之 处 在 所 难免 ， 欢 迎 
大 家 指正 。 读 者 如 果 有 好 的 建议 或 者 在 学 习 本 书 的 
过 程 中 遇 到 问题 ， 请 发 送 邮件 到 
haojia_007@163.com， 和 希望 能 够 与 大 家 一 起 交流 和 


在 看 得 见 的 地 方 学 习 知识 ， 在 看 不 到 的 地 方 学 
习 智慧 。 祝 愿 大 家 在 Spring 的 学 习 道路 上 顺风 顺 
水 。 











和 资源 与 文 持 


本 书 由 异步 社区 出 品 ， 社 区 
Chttps://www.epubit.com/) 为 您 提供 相关 资源 和 后 
续 服 务 。 


fe AC BITVA 


作者 和 编辑 尽 最 大 努力 来 确保 书 中 内 容 的 准确 
性 ， 但 难免 会 存在 疏漏 。 欢 迎 您 将 发 现 的 问题 反馈 
给 我 们 ， 帮 助 我 们 提升 图 书 的 质量 。 


当 您 发 现 错误 时 ， 请 登录 异步 社区 ， 控 书 名 搜 
索 ， 进 入 本 书页 面 ， 扩 击 “ 提 交 勘 误 ”， 输 入 勘误 信 
轧 ， 点 击 “ 提 交 ” 按 钮 即 可 。 本 书 的 作者 和 编辑 会 对 
您 提交 的 勤 误 进行 审核 ， 确 认 并 接受 后 ， 您 将 获 赠 
异步 社区 的 100 积 分 。 积 分 可 用 于 在 异步 社区 部 换 
优惠 疗 、 样 书 或 奖品 。 























与 我 们 联系 


我 们 的 联系 邮箱 是 contact@epubit.com.cn。 


如 果 您 对 本 书 有 任何 疑问 或 建议 ， 请 您 及 邮件 
给 我 们 ， 并 请 在 邮件 标题 中 注 明 本 书 书 名 ， 以 便 我 
们 更 高 效 地 做 出 反馈 。 


如 果 您 有 兴趣 出 版 图 书 、 录 制 教学 视频 ， 或 者 
参与 图 书 翻译 、 技 术 审 校 等 工作 ， 可 以 友 邮 件 给 我 
们 ; 有 意 出 版 图 书 的 作者 也 可 以 到 异步 社区 在 线 拓 
区 投稿 (直接 访问 


www.epubit.com/selfpublish/submissionB|] nf ) 。 


如 果 您 是 学 校 、 培 训 机 构 或 企业 ， 想 批量 购买 
本 书 或 异步 社区 出 版 的 其 他 图 书 ， 也 可 以 发 邮件 给 








3]. 


如 果 您 在 网 上 发 现 有 针对 异步 社区 出 品 图 书 的 
各 种 形 却 的 盗版 行为 ， 包 括 对 图 书 全 部 或 部 分 内 容 
的 非 授 权 传 播 ， 请 您 将 怀疑 有 侵权 行为 的 链接 及 邮 
件 给 我 们 。 您 的 这 一 举动 是 对 作者 权益 的 保护， 也 
是 我 们 持续 为 您 提供 有 价值 的 内 容 的 动力 之 源 。 


A RIDES EIC 


“异步 社区 ”是 人 民 邮 电 出 版 社 旗下 IT 专业 图 书 
和 社区， 致力 于 出 版 精品 全 技术 图 书 和 相关 学 习 产 
品 ， 为 作 译 者 提供 优质 出 版 服务 。 和 寞 步 社区 创办 于 
2015 年 8 月 ， 提 供 大 量 精品 I 技术 图 书 和 电子 书 ， 
以 及 高 品质 技术 文章 和 视频 课程 。 更 多 详情 请 访问 
异步 社区 官网 https:/www.epubit.com 。 


“异步 图 书 ” 是 由 异步 社区 编辑 团队 策划 出 版 的 
精品 I 开 专 业 图 书 的 品牌 依托 于 人 民 邮 电 出 版 社 近 
30 年 的 计算 机 图 书 出 版 积累 和 专业 编辑 团队 ， 相 关 
图 书 在 封面 上 纯 有 异步 图 书 的 LOGO。 卉 步 图 书 的 
出 版 领域 包括 软件 开 及 、 大 数据 、AI、 测 试 、 前 
端 、 网 络 技术 等 。 
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第 1 草 Spring A244 MA BEA 
建 


Spring 是 于 2003 年 兴起 的 一 个 轻 量 级 Java 开 源 
框架 ， 由 Rod Johnson £254 /E Expert One-On-One 
J2EE Design and Development 中 阐述 的 部 分 理念 和 
原型 衍生 而 来 。Spring 是 为 了 解决 企业 应 用 开发 的 
复杂 性 而 创建 的 ， 它 使 用 基本 的 JavaBean 来 完成 以 
前 只 可 能 由 EJB 人 完成 的 事情 。 然 而 ，Spring 的 用 途 
不 仅 限 于 服务 器 疹 的 开 有 ， 从 简单 性 、 可 测试 性 和 
松 耦 合 的 角度 而 言 ， 任 何 Java 必 用 都 可 以 从 Spring 


AX, 24 
^X. fit. o 


1.1 Spring 的 整体 架构 


Spring 框 架 古 一 个 分 层 染 构 ， 它 包含 一 系列 的 
功能 要 素 ， 并 被 分 为 大 约 20 个 模块 ， 如 图 1-1 所 
不 。 


Data Access/Integration 


| Core 


E 
— 


Expression 
[ Context | Language J 
gil 


s 





图 1-1 Spring 整体 架构 图 
这 些 模块 被 总 结 为 以 下 几 部 分 。 
1. Core Container 


Core Container Z LRA) 包含 有 Core、 
Beans. ContextflExpression Language TA . 


Core 和 Beans 模 块 是 框架 的 基础 部 分 ， 提 供 
IoC《〈 转 控制 ) 和 依赖 注入 特性 。 这 里 的 基础 概念 
是 BeanFactory， 它 提供 对 Factory 模 式 的 经 典 实 现 来 
消除 对 程序 性 单 例 模 式 的 需要 ， 并 真正 地 允许 你 从 
程序 逻辑 中 分 离 出 依赖 关系 和 配置 。 


e Core 模 块 主要 包含 Spring 框 架 基本 的 核心 工具 


类 ，Spring 的 其 他 组 件 都 要 用 到 这 sr 
Core 模 块 是 其 他 组 件 的 基本 核心 。 当 然 你 也 
以 在 自己 的 应 用 系统 中 使 用 这 些 工 具 类 。 
Beans 模 块 是 所 有 应 用 都 要 用 到 的 ， 它 包含 访问 
配置 文件 、 创 建 和 管理 bean 以 及 进行 Inversion of 
Control / Dependency Injection 〈IoC/DI) 操作 相 
关 的 所 有 类 。 
Context 模 块 构建 于 Core 和 Beans 模 块 基础 之 上 ， 
提供 了 一 种 类 似 于 JNDI 注 册 器 的 框架 式 的 对 象 
访问 方法 。Context 模 块 继 承 了 Beans 的 特性 ， 为 
Spring 核心 提供 了 大 量 扩展 ， 添 加 了 对 国际 化 

〈 例 如 资源 绑 定 ) 、 事 件 传播 、 资 源 加 载 和 对 
Context 的 透明 创建 的 文 持 。Context 模 块 同时 也 
文 持 J2EE 的 一 些 特 性 ， 例 如 EJB、JMX 和 基础 的 
远程 处 理 。ApplicationContext 接 口 是 Context 模 
块 的 关键 。 
Expression Language 模 块 提供 了 强大 的 表达 式 语 
言 ， 用 于 在 运行 时 查询 和 操纵 对 象 。 它 是 JSP 
2.1 规 范 中 定义 的 unifed expression language 的 扩 
展 。 该 语言 文 持 设置 /获取 属性 的 什 ， 属 性 的 分 
配 ， 方 法 的 调用 ， 访 问 数 组 上 下 文 Caccessiong 
the context of arrays) ~ RAMAR |a. X9 RH 
算术 运算 从 、 命 名 变量 以 及 从 Spring 的 IoC 容 恬 
中 根据 名 称 检索 对 象 。 它 也 支持 list 投 影 、 选 择 
和 一 般 的 list 聚 合 。 


























2. Data Access/Integration 


Data Access/Integration 层 包含 JDBC、ORM、 
OXM、JMS 和 Transaction 模 块 。 


。JDBC 模 块 提供 了 一 个 JDBC 抽 象 层 ， 它 可 以 消 
除 元 长 的 JDBC 编 码 和 解析 数据 库 厂商 特有 的 错 
误 代 人 码 。 这 个 模块 包含 了 Spring 对 JDBC 数 据 访 
问 进行 封装 的 所 有 类 。 

ORM 模 块 为 流行 的 对 象 -关系 映射 API， 如 
JPA、JDO、Hibernate、iBatis 等 ， 提 供 了 一 个 交 
互 层 。 利 用 ORM 封 装 包 ， 可 以 混合 使 用 所 有 
Spring 提供 的 特性 进行 O/R 映 射 ， 如 前 边 提 到 的 
简单 声明 性 事务 管理 。 


SpringfE ZEE A f 4i T ORMTEAS, M pep 
了 ORM 的 对 象 关系 工具 ， 其 中 包括 JDO、Hibernate 
flliBatisSQL Map。 所 有 这 些 都 遵从 Spring 的 通用 事 
务 和 DAO 异 各 层次 结构 。 




















。OXM 模 块 提供 了 一 个 对 ObjecVXML 映 射 实现 的 
抽象 层 ，ObjecVXML 了 映射 实现 包括 JAXB、 
Castor、XMLBeans、JiBX 和 XStream。 

e JMS (Java Messaging Service) 模块 主要 包含 了 
一 些 制造 和 消费 消息 的 特性 。 

e Transaction 模 块 文 持 编程 和 声明 性 的 事务 管理 ， 





这 些 事务 类 必须 实现 特定 的 接口 ， 并 用 对 所 有 
的 POJO 都 适用 。 


3. Web 


Web 上 下 文 模块 建立 在 应 用 程序 上 下 文 模块 之 
上 上 ， 为 基于 Web 的 应 用 程序 提供 了 上 上 下文。 所 以 ， 
Spring 框架 支持 与 Jakarta Struts 的 集成 。Web 模 块 还 
简化 了 处 理 大 部 分 请 求 以 及 将 请 求 参 数 绑 定 到 域 对 
象 的 工作 。Web 层 包 售 了 Web、Web-Servlet、Web- 
Struts 和 Web-Porlet 模 块 ， 有 具体 说 明 如 下 。 


。Web 模 块 : 提供 了 基础 的 面 加 Web 的 集成 特性 。 
例如 ， 多 文件 上 传 、 使 用 servlet listeners 初 始 化 
IoC 容 器 以 及 一 个 面向 Web 的 应 用 上 下 文 。 它 还 
包含 Spring 远程 文 持 中 Web 的 相关 部 分 。 

。 Web-Servlet 模 块 web.servlet.jar: 该 模块 包含 
Spring HJmodel-view-controller (MVC) 实现 。 
Spring 的 MVC 框 架 使 得 模型 范围 内 的 代码 和 web 
forms 之 闻 能 够 清楚 地 分 离开 来 ， 并 与 Spring 框 
架 的 其 他 特性 集成 在 一 起 。 

e Web-Struts 模 块 : 该 模块 提供 了 对 Struts 的 文 
持 ， 使 得 类 在 Spring 应 用 中 能 够 与 一 个 典型 的 
Struts Web 层 集成 在 一 起 。 注 意 ， 该 文 持 在 
Spring 3.0 中 已 被 弃 用 。 

e Web-Porlet 模 块 : 提供 了 用 于 Portlet 环 境 和 Web- 











Servlet 模 块 的 MVC 的 实现 。 
4. AOP 


AOP 模 块 提供 了 一 个 符合 AOP 联 盟 标准 的 面 辣 
切面 编程 的 实现 ， 它 让 你 可 以 定义 例如 方法 拦截 器 
和 切 点 ， 从 而 将 逻辑 代码 分 开 ， 降 低 它们 之 间 的 粳 
合 性 。 利 用 source-level 的 元 数据 功能 ， 还 可 以 将 各 
种 行为 信息 合并 到 你 的 代码 中 ， 这 有 点 像 .Net 技 术 
中 的 attribute 概 念 。 


通过 配置 官 理 特性 ，Spring AOP 模 块 丰 接 将 面 
问 切 面 的 编程 功能 集成 到 了 Spring 框架 中 ， 所 以 可 
以 很 容易 地 使 Spring 框 架 管理 的 任何 对 象 文 持 
AOP. Spring AOP 模 块 为 基于 Spring 的 应 用 程序 中 
的 对 象 提供 了 事务 管理 服务 。 通 过 使 用 Spring 
AOP， 不 用 依赖 EJB 组 件 ， 吏 可 以 将 声明 性 事务 管 
理 集 成 到 应 用 程序 中 。 


。Aspects 模 块 提供 了 对 AspectJ 的 集成 文 持 。 

e [Instrumentation EX fz f class instrumentation x. 
持 和 classloader 实 现 ， 使 得 可 以 在 特定 的 应 用 服 
务 器 上 使 用 。 








5. Test 


Test 模 块 支持 使 用 JUnit 和 TestNG 对 Spring 组 件 
进行 测试 。 


1.2 ”环境 搭建 


由 于 在 上 一 版 本 中 作者 对 环境 搭建 描述 得 比较 
ALB SERES E Hy. PERE TELE ANAK 
意 ， 并 在 这 一 版本 中 补充 了 非常 详细 的 Spring 环境 
搭建 流程 。 如 果 是 第 一 次 接触 Spring 源码 的 环境 搭 
建 ， 确 实 还 是 比较 麻烦 的 。 


作者 使 用 的 编译 器 为 目前 流行 的 IntelljJ 
IDEA， 版 本 为 2018 旗舰 版 。Eclipse 用 户 还 需要 自 
Citi PRIA DSA EDTA, IK ALAN RIA 








1.2.1 源码 链接 获取 


1. 输入 GitHub 官 网 网 址 并 搜索 spring， 如 图 1- 
2 所 示 。 





Built for 
developers 


GitHub is a development platform inspired by 








图 1-2” GitHub 上 的 spring 搜 索 


2. 找到 对 应 的 spring-framework 的 工程 ， 点 击 
链接 进入 ， 如 图 1-3 所 示 。 





© sea 
a * 
Groovy 
Advanced search Cheat sheet 

spring-projects/spring-boot @ Java K 23.1k 
Spring Boot 

spring-projects/spring-framework @ Java * 20.2k 
Updated 39 minutes ago 

seaswa Iker/Spring @ Java * 562 


K|1-3 GitHub_EMJspring-framework 


3. 切换 为 最 新 的 Spring 5.0.x 版 本 源码 ， 如 图 1- 
4 所 示 。 


@ GitHub, Inc. [US] https://github.com/spring-projects/spring-framework 


XD 16,391 commits V 13 branches 9 123r 
T 





| Branch: master v 








Switch branches/tags limientation: ii 
| nove spring-asm and inline ASM 4 into spring-c 
Branches Tags 5st dependency updates (POI 3.17, Rome 1.8, EF 
3.0.x jrade to Gradle 4.6 
34x isistent treatment of proxy classes and interfac: 
32x jrade to AspectJ 1.9 GA 
4.0.x jrade to Gradle 4.6 
4.1.x jrade to Reactor Bismuth SR7, Hibernate ORM £ 
pe ‘ised mime.types file with cpp extension and up: 
isistent treatment of proxy classes and interfaci 
lotationUtils.annotatedInterfaceCache available 
lability refinements (based on IntelliJ IDEA 2018 
eanbulilder 


BOM link 


conversation 
est dependency updates (POI 3.17, Rome 1.8, EF 


gh-pages 


图 1-4 切换 为 最 新 的 Spring 5.0.x 版 本 源码 
4. 获取 Git 分 支 链 接 ， 如 图 1-5 所 示 。 


Spring Framework http://projects.spring.io/spring-fram... 


framework ^ spring ^ spring-framework 


(D 16,383 commits P 13 branches © 123 releases 11 269 contributors 





Find file Clone or download * 


This branch is 6 commits ahead, 14 commits behind master. Clone with HTTPS © 


M :deleuze improve Kotlin + bean validation documentation = aa Oi onteco bs ne web URE 


https://github.com/spring-projects/sprin | (fg 


ii .settings/gradle Remove spring-asm and inline ASM 4 into spring-core 
iil buildSrc Latest dependency updates (POI 3.17, Rome 1.8, EhCe z 
P UP | 1 Open in Desktop Download ZIP 
iia gradle Fix Dokka reference to Spring Framework's Javadoc o days ago 


图 1-5 ”获取 Git 分 支 链接 
1.2.2. WB Fay XIDEAS A 


1. IDEA F Spring Git 拉 取 分 支 ， 如 图 1-6 所 


人 小。 


Welcome to IntelliJ IDEA 


IntelliJ IDEA 


3* Create New Project 
< Import Project 
Open 


$ Check out from Version Control » 
CVS 
Git 
Mercurial 
Subversion 


图 1-6 IDEA F Spring Git 拉 取 分 支 


2. 本 地 安 六 目 录 设 置 ， 如 图 1-7 所 示 。 


e e Clone Repository 
URL: | https://github.com/spring-projects/spring-framework.git B Test 


Directory: /Users/haojia/git/spring-framework 


Log in to GitHub... Cancel 
图 1-7 本 地 安装 目录 设置 


3. 拉 取 等 待 ， 如 图 1-8 所 示 。 


IntelliJ IDEA 


ersion 2018.1 


Cloning source repository https://github.com/spring-projects/spring-fram... 





Cancel 


| Background | 


we —D—— ——— HQ 


Al1-8 dH 


4. IDEA 导 入 ， 如 图 1-9 所 示 。 







Checkout From Version Control 

Would you like to create an IntelliJ IDEA project 
for the sources you have checked out to 
JUsers/haojia/git/spring -framework? 





3* Create New Project 


Import Project 
5 Open 


$ Check out from Version Control ~ 


图 1-9 _ IDEA 导入 


5. Gradle 项 目 导 入 ， 如 图 1-10 所 示 。 


| e e Import Project 


| ^ Create project from existing sources 
© Import project from external model 


© Eclipse 


@ Flash Builder I 


M Maven 


? Cancel 


图 1-10  GradleJji H SA 


e e Import Project 


Gradle project: ~/git/spring-framework 
Use auto-import 
Create directories for empty content roots automatically 
Group modules: © using explicit module groups using qualified names 


Create separate module per source set 
© Use default gradle wrapper (recommended) 
Use gradle 'wrapper' task configuration @ Grade wraoper customization in build script 


Use local gradle distribution 





Gradle home: 
Gradle JVM: © Use Project JDK (java 1.8.0. 12 
Project format: .idea (directory based) 


+ Global Gradie settings 


? Cancel 





[zulu8.20.0.5-jdk8.0. 





图 1-11 工程 属性 设置 





6. 工程 属性 设置 ， 如 图 1-11 所 示 。 


121-mac: 








Previous 


7. 导入 后 界面 展示 ， 如 图 1-12 所 示 。 


TU nl 


spring-framework [~/git/spring-framework] 





v|j 4+ @ Baw OE 


¥VePoO A FRO L 


p 








Äi 

* Messages: Build ~ 
© Information: 18/4/10 上 午 9:56 - Compilation completed with 18 errors and 2 warnings in 7s 187ms 
@ Warning: Kotlin: Classpath entry points to a non-existent location: /Users/haojia/git/spring-framework/spring-core/build/libs/spring-objenesis-repack-2.6.jar 


图 1-12 ”导入 后 界面 展示 


gh =| 


Ws spring-framework [spring] ~/git/spring-f 


» B .gradle 


> "$buildSrc [spring-build-src] 


» Ps gradle 

» Mout 

» Pispring-aop 

> B spring-aspects 

» Mspring-beans 

» B spring-context 

» Ws spring-context-indexer 
» B spring-context-support 


> Mspring-expression 

> B spring-framework-bom 
» B spring-instrument 

» B spring-jcl 

» MW spring-jdbe 

» Mspring-jms 

> B spring-messaging 





= > © spring (root) - 


» © :spring-aop 
» ®© :spring-aspects 
> © :spring-beans 
> (8 :spring-build-src. 
'spring-context 
ing-context-indexer 
'ing-context-support 
spring-core 
> (P :spring-expression 
> © :spring-framework-bom 
> (9 :spring-instrument 
» (8 :spring-jcl 
> @:spring-jdbe 
> © :spring-ims 
> © :spring-messaging 
> © :spring-om 
> © :spring-oxm 
> © :spring-test 


1.3 ”cglib 和 objenesis 的 编译 


> 


1.3.1 


问题 肥 现 及 原因 


错误 信息 获取 ， 如 图 1-13 所 示 。 


pling wy #c — dsrif)  uonepueAueog @ — siooloid uonew i eseaned |i) 





-Spring-framework ， .spring-core src. main > M java org springframework objenesis > © SpringObjenesis 
















i E Project ~ = | #- i 
E core Feed 
B lang x ; ; A 
E 7 . package org.springframework.objenesis; 

objenesis 一 

总 package-info.java ifort ta aides A a ee An Arey 

* E 2 0 import org.springframework.objenesis.instantiator]|ObjectInstantiator; 
Spungablenesls import or .0 strategy. Instantia 
util import org. J strategy. StdInstanti 
ie overview.html import org.springframework.util.ConcurrentReferenceHashMap; 
© kotlin Tiii 
p test * Spring-specific v of {@link ObienesisStd} / {@link ObienesisBase}, 





© spring-core.gradle 


Messages: Build 
@ Information: Kotlin: kotlinc-jvm 1.2.30 (JRE 1.8.0_121-b15) 


s = @ Information: java: Errors occurred while compiling module 'spring-core main' 
DES Q Information: javac 1.8.0 121 was used to compile java sources 
x à @ Information: Modules "spring-framework-bom. main", "spring-framework-bom test", "spring-jms main", "spring-jcl test", "spring-messaging. main" and 
project configuration/dependencies changes 
$ @ Information: 18/4/10 上 午 9:56 - Compilation completed with 18 errors and 2 warnings in 7s 187ms 
+ YF © Warning: Kotlin: Classpath entry points to a non-existent location: /Users/haojia/git/spring-framework/spring-core/build/libs/spring-objenesis-repack-2 





m" @ Warning: Kotlin: Classpath entry points to a non-existent location: /Users/haojia/git/spring-framework/spring-core/build/libs/spring-cglib-repack-3.2.6.j 
3^. [Users/haojia/git/spring-framework/spring-core/src/main/java/org/springframework/objenesis/SpringObjenesis.java 
© Error:(20, 50) java: 程序 包 org.springframework.objenesis.instantiator 不 存在 
@ Error:(21, 46) java: 程序 包 org.springframework.objenesis.strategy 不 存在 
@ Error:(22, 46) java: 程序 包 org.springframework.objenesis.strategy 不 存在 
@ Error:(35, 41) java: 找 不 到 符号 
符号 : 类 Objenesis 
@ Error:(47, 23) java: 找 不 到 符号 
符号 : 类 InstantiatorStrategy 
RE: 类 org: springframework.objenesis.SpringObjenesis 


图 1-13 ”错误 信息 获取 


为 了 避免 第 三 方 class 的 冲突 ，Spring 把 最 新 的 
cglib 和 objenesis 给 重新 打包 (repack) 了 ， 它 并 没 
有 在 源码 里 提供 这 部 分 的 代码 ， 而 是 直接 将 其 放 在 
jar 包 当中 ， 这 也 束 导 致 了 我 们 拉 取 代码 后 出 现 编译 
音 误 。 那 么 为 了 通过 编译 ， 我 们 要 把 缺失 的 jar 补 回 


o 





1.3.2 |n] UE I 


1. 缺失 jar 引 入 ， 如 图 1-14 所 示 。 


4 日 
+ 


3 spring-framework [spring] ~/git/spring-framework 
> Bs .gradle 
-jdea 
.Settings 
> Pw build 
= buildSrc [spring-build-src] 
gradle 
> Bm out 
2 spring-aop 
2 spring-aspects 
2 spring-beans 
2 spring-context 
z spring-context-indexer 
& spring-context-support 
& spring-core 


4 spring-cglib-repack-3.2.0.jar 


| spring-objenesis-repack-2.1.jar 





sre 
(© spring-core.gradle 
2 spring-expression 


图 1-14 缺失 jar 引 入 
2. 新 增 jar 在 Gradle 中 生效 ， 如 图 1-15 所 示 。 


5 spring-framework ` WS spring-core ` (® spring-core.gradle 














I$! Project + = œ- I+ € SpringObjenesis java (8 spring-core.gradle dle projects % > 
> B build This file is indented with tabs instead of ... OK Indent with 4 spaces Show Settings [s] -:9:-* = 
 buildSrc [spring-build-src] om UPLAUIIOL, AU. EOL LAYER. AJover PU AJOVOVET SAUNI 7 - 
radie 85 optional("io. reactivex:rxj. reactive-streams:$(rxjavaAdapterVer © “© spring 
9 optional("io.reactivex.rxj. java: S(rxjava2Version)") (© spring (root) 
» Mout 8 optional("io.netty:netty-buf : 
% spring-aop 8 testCompile( :reactor-test") spragsagp 





testCompile( xml. bind: jaxb-api:2.3.0") 
| testCompile("org.apache.tomcat.embed: tomcat-embed-core:${tomcatVe 
= 9 testCompile("com.fasterxml.woodstox:woodstox-core:5.0.3") ( 


ring-aspects 
spring-beans 
ring-build-src 


$ spring-aspects 
$5 spring-beans 














= spring-context 32 exclude group: "stax", module: "stax-api" k 
pepr gcontaetha 34 konpite fleTree (dir: "tibs" „include : jar is at: 
$ spring-context-support 5 } » ring-context-indexe 





= spring-core 9 spring-context-suppo 








libs ] jar { ring-core 
" 。 // Inline repackaged cglib classes directly into spring-core jar ring-expression: 
‘| spring-cglib-repack-3.2.0.jar 9 dependsOn cglibRepackJar aoe ei 
H spring-objenesis-repack-2.1.jar from(zipTree(cglibRepackJar.archivePath)) { p eid 
> i out include "org/springframework/cglib/s" ring-instrument 
} ring-jcl 
dependsOn objenesisRepackJar ring-jdbc 
from(zipTree(objenesisRepackJar.archivePath)) ( spring-jms 
10 include "org/springframework/objenesis/»" uos : 
= spring-framework-bom e } rng; nesssgg 
wa ring-orm 
= spring-instrument ble M, eee 
> E sorina-icl dependencies{} 


图 1-15 ”新 增 jar 在 Gradle 中 生效 
因为 整个 Spring 都 在 Gradle 环 境 中 ， 所 以 要 使 


jar 生 效 束 必须 更 改 Gradle 配 置 文件 : 


compile fileTree(dir 


: 'libs' 
,include 


po Tar" 





1.4 ”AspectJ 编 详 问 题解 决 


1.4.1 问题 发 现 


当 完 成 以 上 的 jar 包 导入 工作 并 进行 重新 编译 
后 ， 发 现 还 是 有 编译 错误 提醒 ， 
Ip 如 图 1-16 所 示 ， 发 现 居然 是 
不 到 








mue i Y YvsesuwonooEBEGIF WO 
".spring-framework ^ spring-aspects isrc ) main > Mi java ) org springframework > BS cache aspect] > © AspectJCachingConfiguration 
É Project ~ * - Sa ias e. AspectJCachingConfiguration java Grat 
v- * @see org.springframework.cache.annotation.EnableCaching o 

B Y org * @see org.springframework.cache.annotation. Cachingontigurationsetec 

[^ E springframework */ ë 
" @Configuration < 
> Bi beans 17 $ public class AspectJCachingConfiguration extends AbstractCachingConfic 





39 @Bean(name = CacheManagementConfigUtils.CACHE ASPECT BEAN NAME) 


aspect = so F eRole(BeanDefinition.ROLE INFRASTRUCTURE) 

4) AbstractCacheAspect 41$ public BnnotationCacheAspect cacheAspect() { á 

'^ AnnotationCacheAspect 42 AnnotationCacheAspect cacheAspect = AnnotationCacheAspect.a: > 

© AnyThrow 43 if (this.cacheResolver != null) { " 
x x 44 cacheAspect.setCacheResolver(this.cacheResolver) ; 

'€ AspectJCachingConfiguration ae } > 


else if (this.cacheManager != null) { 


© AspectJJCacheConfiguration 
cacheAspect. setCacheManager (this. cacheManager) ; > 


* JCacheCacheAspect 





context 49 if (this.keyGenerator != null) { 
scheduling 50 cacheAspect. setKeyGenerator(this.keyGenerator); > 
» Fs transaction } > 
arse 2 if (this.errorHandler !- null) ( 
sm overview.html 5 cacheAspect. setErrorHandler(this.errorHandler); 
= resources 54 让 > 
atest =a ———! > 
© spring-aspects.gradle AspectJCachingConfiguration cacheAspect() 


Problems 


Q9 Information: java: Errors occurred while compiling module 'spring-aspects main" 
© Information: javac 1.8.0. 121 was used to compile java sources 
* * 号 [Users/haojia/git/spring-framework/spring-aspects/src/main/java/org/springframework/cache/aspectj/AspectJCachingConfiguration.javi 
Q Error:(41, 16) java: 找 不 到 符号 
符号 : 类 AnnotationCacheAspect 
位 置 : 类 org.springframework.cache.aspectj.AspectJCachingConfiguration 
@ Error:(42, 17) java: 找 不 到 符号 
符号 : 类 AnnotationCacheAspect 
位 置 : 类 org.springframework.cache.aspectj.AspectJCachingConfiguration 
@ Error:(42, 53) java: 找 不 到 符号 
符号 : 变量 AnnotationCacheAspect 
位 置 : 类 org.springframework.cache.aspectj.AspectJCachingConfiguration 
* g- [Users/haojia/git/spring-framework/spring-aspects/src/main/java/org/springframework/scheduling/aspectj/AspectJAsyncConfiguration.j 
@ Error:(43, 16) java: 找 不 到 符号 


3 
3B Bie lk fol 


Jp Z: Favorites 


Structure 


图 1-16 ”问题 发 现 
aspect 关 键 字 Java 语 法 违背 
可 是 我 们 明明 能 看 到 对 应 的 类 就 在 工程 里 


为 什么 会 找 不 到 呢 ? 于 是 打开 对 应 的 类 查看 ， 如 图 1 
17 所 示 。 












-— —á 


+ %- I+ € AspectJCachingConfiguration.java 








org 
springframework 
beans $ 2x 
T 9 
41€ pubtid aspect JnnotationCacheAspect extends AbstractCacheAspect { 
LÀ ADE tSCLCacie At public AnnotationCacheAspect() { super(new AnnotationCacheOperati 
'^ AnnotationCacheAspect - 


'€ AnyThrow 

'€ AspectJCachingConfiguration 
© AspectJJCacheConfiguration 
^ JCacheCacheAspect 


thod in a type w. 
with the {@code @Ca 





private pointcut executionOfAnyPublicMethodInAtCacheableType() : 
execution(public * ((@Cacheable *)+).*(..)) && within(@Cachez 





scheduling 
transaction 


ie» overview.html 
= resources 


tact 





AnnotationCacheAspect 


@ Information: java: Errors occurred while compiling module 'spring-aspects_main' 
@ Information: javac 1.8.0_121 was used to compile java sources 
¿+ [Users/haojia/git/spring-framework/spring-aspects/src/main/java/org/springframework/cache/aspectj/AspectJCachingConfiguration 


© Error:(41, 16) java: 找 不 到 符号 
符号 : 类 AnnotationCacheAspect 
位 置 : 类 org.springframework.cache.aspectj.AspectJCachingConfiguration 


@ Error:(42, 17) java: 找 不 到 符号 
符号 : 类 AnnotationCacheAspect 
位 置 : 类 org.springframework.cache.aspectj.AspectJCachingConfiguration 


图 1-17 ”aspect 关键 字 Java 语 法 违背 


及 现 类 的 声明 后 然 使 用 了 aspect 而 不 是 class， 
我 瞬间 吸 了 口 凉 气 ， 太 久 没 充电 了 ，JDK 新 出 的 语 
法 变化 这 么 大 都 没 关 注 ， 经 过 几 番 周折 后 终于 在 
AspectJ 的 使 用 上 找到 了 答案 。 


1.4.2 ”问题 原 


AOP (Aspect Orient Programming, H J=) t7] [f] 
WE ENAR RAE RE SHV Ze ak 
FA — fh E BCS FAN HI S EE 思想、 。 其 实 AOP 问 世 的 时 间 
并 不 长 ， 甚 至 在 国内 的 翻译 还 不 太 统 一 〈( 男 有 人 翻 
译 为 “ 面 同方 面 编程 ”〉。 





If] AOP¢ Spring F tH h Da 2$ e e RBS TE HH. 
可 以 说 没有 AOP 就 没有 Spring 现在 的 流行 ， 当 然 
AOP 的 实现 有 些 时 候 也 依赖 于 AspectJ。 


AspectJ 实 现 AOP 





脱离 了 Spring， 我 们 可 以 单独 看 看 AspectJ 的 使 
用 方法 。 

AspectJ 的 用 法 很 简单 ， 残 像 我 们 使 用 JDK 编 
译 、 运 行 Java 程 序 一 样 。 下 面 通 过 一 个 简单 的 程序 
来 示范 AspectJ 的 用 法 : 





public class HelloWworld { 
public void sayHello(){ 
System.out.println("Hello AspectJ!"); 


public static void main(String args[]) { 


Helloworld h = new Helloworld(); 
h.sayHello(); 





坚 无 疑问 ， 结 果 将 输出 “Hello Aspect IF 
串 。 假 设 现 在 客户 需要 在 执行 SayHello 方 法 前 启动 
事务 ， 当 该 方法 结束 时 关闭 事务 ， 则 在 传统 编程 模 
式 下 ， 我 们 必须 手动 修改 sayHello 方 法 一 一 如 果 改 
为 使 用 AspectJ， 则 可 以 无 须 修 改 上 面 的 sayHello 方 
法 。 下 面 我 们 定义 一 个 特殊 的 “类 >”: 











public aspect TxAspect { 
void around():call(void sayHello()) { 
System.out.println("Transaction Begin"); 
proceed(); 


System.out.println("Transaction End"); 


j 
j 








能 有 人 已 经 发 现 ， 在 上 面 的 类 文件 中 不 是 使 
用 "s, interface Bk 7 enum A 7E 定义 Java 类 ， 而 是 使 
用 aspect 难道 Java 语 言 义 增 加 关键 字 了 :4 ? No! 
上 面 的 TxAspect 根 本 不 是 一 个 Java 类 ， 所 以 aspect 也 
不 是 Java 文 持 的 关键 字 ， 它 》 只 是 Aspect] 才 认识 的 天 
键 字 。 


上 面 void around 中 的 内 容 也 不 是 方法 ， 它 只 是 
指定 当 程 序 执行 HelloWorld 对 象 的 sayHello 方 法 
时 ， 执行 这 个 代码 块 ， FN 其 中 proceed 表 示 调 用 原 来 的 
sayHello 方 法 。 正 如 前 面 提 到 的 ， 因 为 Java 无 法 识 
别 TxAspect.java 文 件 中 的 内 容 ， 所 以 我 们 需要 使 用 
ajc.exe 来 执行 编译 : 


ajc Helloworld.java TxAspect.java 


我 们 可 以 把 ajc 命 令 理解 为 javac 命 令 ， 两 者 都 
用 于 编译 Java 程 序 ， 区 别 是 ajc 命 令 可 以 识别 AspectJ 
的 语法 。 从 这 个 角度 看 ， 我 们 可 以 将 ajc 命 令 当成 增 
强 版 的 javac 命 令 。 














运行 该 HelloWorld 类 依然 无 顷 任 何 改 变 ， 其 结 
RU P: 


Transaction Begin 
Hello AspectJ! 
Transaction End 





从 上 面 的 运行 结 末 来 看 ， 我 们 可 以 完全 不 修改 
HellowWorld.java 文 件 ， 也 不 用 修改 执行 HelloWorld 
的 命令 ， 就 可 以 实现 上 文中 的 实现 事务 管理 的 需 
求 。 上 面 的 Transaction Begin 和 Transaction End 仅 仅 
是 模拟 事务 的 事件 ， 实 际 开发 中 ， 用 代码 蔡 换 掉 这 
段 输出 即 可 实现 事务 管理 。 








1.4.3 ”问题 解决 
1. 下 载 AspectJ 的 最 狐 稳定 版 本 


安装 AspectJ 之 前 ， 请 确保 系统 已 经 安装 了 
JDK. 


下 载 下 来 后 是 一 个 jar 包 ， 如 图 1-18 所 示 。 


Latest Stable Release 
* Aspect) 1.9.0, Released 2 Apr 2018 


: " : aspectj-1.9.0.jar (-17M) 
Aspect) compiler, browser, documentation tool, Ant tasks, and documentation. 


AspectJ 8 


* Aspect) 1.8.13, Released 15 Nov 2017 





aspectj-1.8.13.jar (-15M) 


Aspect] compiler, browser, documentation tool, Ant tasks, and documentation. aspectj-1.8.13-src.jar 


* Aspect) 1.8.11, Released 26 Sep 2017 
aspectj-1.8.11.jar (-15M) 


EE MAE dim aad acci a 


图 1-18 ”下载 AspectJ 的 最 新 版 本 


Aspect] compiler, browser, documentation tool, Ant tasks, and documentation. 


2. AspectJ 安装 


打开 命令 行 ，cd 到 该 jar 包 所 在 的 文件 夹 ， 运 行 
java -jar aspectj-1.9.0.jar 命 令 ， 打 开 AspectU 的 安装 界 
面 。 第 一 个 界面 是 欢迎 界面 ， 直 接点 击 Next， 如 图 
1-19 所 示 。 


E Prok @ @ e Installer for AspectJ(TM) notationCacheAsper 


jnotation on a i 
the class ann 


E isibility). An 
as Pect J iunio ror 


tAspect extends 


à 
| 





Installer for AspectJ 9 Development Kit™ 
| ject() { super( 


Version 1.9.0 built on Monday Apr 2, 2018 


of any public i 


This installs the complete AspectJ 9 Development Kit (AJDK) distribution, with the compiler, aspect type of a type 


libraries, structure browser, ant tasks, documentation, and examples. This distribution is covered by the 
Eclipse Public License (see http://www.eclipse.org/legal/epl-v10.html). nOfAnyPublicMe 


@Cacheable *)+ 
For IDE integrations or source code, see the project home page at http://eclipse.org/aspectj 


Copyright (c) 1998-2001 Xerox Corporation, 2002 Palo Alto Research Center, Incorporated, 2003-2008 lof any public ı 
Contributors. All rights reserved. type of a type 


nOfAnyPublicMe 


@CacheEvict x) 
Press Next to continue. At any time you may press Cancel to exit the installation process. 


m Back Next y Cancel EE 
> 


Terminal 















java -jar aspectj-1.9.0.jar 


+ ,haojiadeMacBook-Pro:Downloads haojia 


x 


— 


al 


% 9: Version Control [E] Terminal Į Build Á Problems Wh Java Enterprise Spring 周 0:Messages ——*6: TODO 


图 1-19 AspectJ %3% 


在 图 1-20 所 示 的 第 二 个 界面 中 选择 jre 的 安 猴 路 
fe, ASE At Next. 





eoe Installer for AspectJ(TM) 

e nstaller has succe: Vende ee S pot ath to your Java home (J2SE 1.4 or greater). This pat! phim a used 
athe Staal Joy a loc when gen pede i a a ese ld and ci ools. 

Unles ss you know that ns puros peste suggest that ss Next 





医 home directory 


slications/zulu8.20.0.5-jdk8.0.121-macosx_x64/zulu8.20.0.5-jdk8.0.121-macosx_x64 | 





Back (Next. | Cancel 





图 1-20 AspecJ JDK Æ 


在 图 1-21 所 示 的 第 三 个 界面 中 选择 AspectJ 的 安 
装 路 径 ， 点 击 Install。 因 为 安装 过 程 的 实质 是 解压 
一 个 压缩 包 ， 并 不 需要 太 多 地 依赖 于 系统 ， 因 此 路 
径 可 以 任意 选择 ， 这 里 选择 和 Java 安 装 在 一 起 。 


eoe. Installer for AspectJ(TM) 





irectory into which to instal 
the installation p: y 


图 1-21 AspecJ 安装 目录 


至 此 ，AspectJ 安 装 完成 。 


3. IDEA 对 Ajc 文 持 官方 文档 (使 用 AspectJ 编 译 
air ) 

此 功能 仅 在 Ultimate 版 本 中 得 到 支持 。 

EU UL F, IntelliJ IDEA 使 用 Javac 编译 
wo ZIEH Aspect 编译 器 Ajc (而 不 是 与 javac 组 
合 ) ， 应 对 相应 的 IDE 设置 进行 更 改 。 


项 目 级 别 指定 的 Ajc 设置 可 以 在 各 个 模块 进行 
人 微调。 与 模块 相关 的 AspectJ 用 于 此 目的 。 


请 注意 ，Ajc 不 与 IntelliJ IDEA 捆绑 在 一 起 ， 它 


是 Aspectj 发 行 版 的 一 部 分 ， 您 可 以 从 AspectJ 网 站 
下 载 。 


将 Ajc 与 Javac 结 合 使 用 可 以 优化 编译 性 能 ， 
IntelliJ IDEA 可 把 二 者 组 合 起 来 ， 而 无 须 在 IDE 设 
置 中 切换 编译 器 。 


首先 ， 您 应 该 选择 Ajc 作 为 项 目 编译 器 (在 
Java 编译 器 页 面 上 的 Use 编译 器 字段 ) 。 


如 果 您 想 要 同时 使 用 Javac， 请 打开 “Delegate to 
Javac” 选 项 。 如 果 启 用 此 选项 ， 那 么 没有 aspect 的 
模块 将 被 编译 为 Javac GH EHR) ， 并 日 包 合 
aspect 的 模块 将 用 Ajc 编译 (如 果 此 选项 为 off， 则 
Ajc 用 于 项 目 中 的 所 有 模块 〉。 


您 可 以 在 各 个 模块 级 别 对 编译 器 〈Ajc 和 
Javac) 之 间 的 任务 分 配 进行 微调 。 对 于 只 包含 
@Aspect-annotated 的 Java 类 (Æ java 文件 中 ) 的 
形式 的 模块 ， 您 可 以 指定 Ajc 仅 应 用 于 后 编译 的 编 
ZA (weaving) 。 如 有 果 这 样 做 ， 则 Javac 将 用 于 编译 
所 有 源 文 件 ， 然 后 Ajc 将 其 应 用 于 编译 的 类 文件 进 
行 编织 。 因 此 ， 整 个 过 程 ( 编 译 + 编 织 ) 

(compilation + weaving) 将 花费 更 少 的 时 间 。 














如 果 打 开 了 “Javac 代 理 选 项 (Delegate to 


Javac) ”， 则 通过 在 与 模块 关联 的 AspectJ Facets 
打开 相应 的 选项 来 启用 Ajc 的 编译 后 编织 模式 。 


请 注意 ， 不 应 为 包含 代码 样式 aspect 的 模块 
(在 .aj 文件 中 定义 的 aspect) 启用 此 选项 。 


4. 7jspring-aspect I 1 75 JJllFacets/& T^t 


按照 IDEA 官 网 说 明文 档 尝 试 对 AspectJ 项 目 加 
Facets， 如 图 1-22 一 网 1-26 所 示 。 








RGN ILLA E ruit view Navigate vuutc Allalyze Neal Dunu ru 1OUIS 
d New » F b 
Bee 5» Open... ects/src/main/java/org/springf 
& M B e| OpenURL. Kvom]oygW 
Open Recent » 
a spring-frame\ — Close Project 
j EP Project ~ © AspectJCachingConfiguration.java 
D Project Structure... Be T UE r 
: i * @author Stephane 
à Ba .grad| Other Settings > b dicerc 
| P Sync Settings to JetBrains Account... 3 * @see org.springfré 
-idea 4 * @see org.springfré 
-settii Import Settings... 5 */ 
Ml build Export Settings... 6 - rc gd in " 
= builds Export to Eclipse... b public class Aspect 
grad, Export to Zip File... 9 @Bean(name = Cact 
B9 out Settings Repository... ® GRole(BeanDef init 
sprim Convert Module Groups to Qualified Names... 17 public Annotatior 
a { 2 AnnotationCac 
asprin 1: Save All ss ? if (this.cact 
Bou 一 A 4 cacheAspe 
$$ Synchronize xY 5 
f Invalidate Caches / Restart... 6 else if (this 
A ] cacheAspe 
Export to HTML... x A Ginka 
in 9 i is. key 
's Print... 0 cacheAspe 
Add to Favorites > 1 
2 if (this.errc 
Line Separators >E SacneAspt 
Make Directory Read-only 5 return cache/ 
6 } 


Power Save Mode 


图 1-22 ”设置 Facets (1) 


sprit e e 











me som 
| Add 
Project Setti 
phe iis Ex Android Targ 
» roja iĝ Android-Gradle 
> Modules @ APK 
Libraries Een 
E KR EJB 
hi i API * 
» PETER 4& Google App Engine 
4 图 GWT 
Platform Settings €) Hibernate Corc 
>| SDKs 
4 Java-Gradle Addi 
| Global Libraries Wi, JavaEE Application 
FE JPA Kotlit 
Problems 区 Kotlin Sci 
iĝ Native-Android-Gradle 
i OSGi Sci 
© Seam 
@ Spring 
pring undle 
Spring DM Bundi 
JU 
图 1-23 设置 Facets (2) 
ece Choose Module 
AspectJ facet will be added to selected module 
s spring 
$ spring-aop 


'$ spring-aop test 

2 spring-aspects 

2 spring-aspects main 
2 spring-aspects test 
2 spring-beans 

2 spring-beans main 
2 spring-beans. test 

$ spring-build-src 


2 spring-build-src main 
= spring-build-src test 


2 spring-context 


& spring-context-indexer 


i spring-context-indexer main 


2 spring-context-indexer test 


2 spring-context-support 


图 1-24 


Cancel 


设置 Facets (3) 


eco Choose Module 


AspectJ facet will be added to selected module 
2 spring 
2 spring-aop 
5 spring-aop test 
"3 spring-aspects 
& spring-aspects test 
= spring-beans 
& spring-beans main 
& spring-beans test 
& spring-build-src 
2 spring-build-src main 
"$ spring-build-src test 
2 spring-context 
"$ spring-context-indexer 
& spring-context-indexer main 
"$ spring-context-indexer test 
M spring-context-support 
8 spring-context-support, main 


Cancel 


图 1-25 ”设置 Facets (4) 


> "spring main Target platform: 小 
> "Xspring test 


| > Bzspring-aop Report compiler v 





v M; spring-aspects Language version 
2 spring-aspects 
v P"ispring-aspects main API version 
© AspectJ |... Coroutines (experime 
KK + Add > 
v 号 spri onal command | 
Delete ES 
2 Co criptin 
Ek py... scripting 
> "= spring- C) Find Usages Xr7 Dt template clas: 
> F spring- 
> Bg spring- tf Hide Module Groups Pt templates cla: 
> B spring- = Expand All + 
> B spring- = Collapse All 38 
^» Cz enrina-cnare E 


图 1-26 ”删除 Facets 


5. Sane 45 


编译 如 要 改 为 Ajc， 同 时 要 设置 Ajc 的 安装 目 
录 ， 如 图 1-27 所 示 。 记 住 ， 要 选择 到 aspectjtools.jar 
这 个 层面 ， 同 时 ， 务 必要 选择 Delegate to Javac 选 
项 ， 它 的 作用 是 只 编译 AspectJ 的 Facets 项 目 ， 而 其 
他 则 使 用 JDK 代 理 ， 如 图 1-28 所 示 。 如 果 不 勾 选 ， 
则 全 部 使 用 Ajc 编 译 ， 那 么 会 导致 编译 错误 。 如 网 1- 
2OATAN, FAAS BLA AJC. 





Gradle projects Xt. c! 


an G+ - © Fem oe | 


Hes er e a 
(® spring (root) 
3 © :spring-aop 
(© :spring-aspects 
"OR | (© :spring-beans 
© :spring-build-src 


otationCe (5 :spring-context 
- © :spring-context-indexer 
in a type (© :spring-context-support 
he {@code (5 :spring-core 
tCacheabU (© :spring-expression 
) && with e :spring-framework-bom 
— (© :spring-instrument 
in a type © :spring-jcl 
he (Gcode © :spring-jdbc 
(€ :spring-jms 


tCacheEvi - j " 
; (e :spring-messaging 


(© :spring-orm 
© :spring-oxm 
© :spring-test 


图 1-27 ”Gradle 入 口 更 改编 译 器 


. e Preferences 
















2° ler > Java Compiler For c Rese 
Appearance & Behavior 
Kevmap à Use '—-release' option for cross-compilation (Java 9 and later) 
Editor 
Plugins Project bytecode version: Same as language level BJ 
Version Control Per-module bytecode version: 
Build, Execution, Deployment Module Target bytecode version 
Buld Tool. . 1 spring-aop. main 18 
fren 1 = spring-aop test 18 
NER * 3 spring-aspects main 18 
radie 
HUN : = spring-aspects test 18 
m = sprina-beans main 18 
Compiler e a 
aCe Ajc Options 
‘Annotation Processors r : : 
Det : Path to Ajc compiler: | /Users/h: r v= m Test 
alidation 
RMI Compiler f 
Groovy Compiler 1 Command line parameters: 
ActionScript & Flex Compiler 上 
Android Compilers e 
Kotlin Compiler e Generate debug info 
Debugger 
Remote Jar Repositories 1 
uas i 3 Delegate to Javac 
ploymen 
Arquillian Containers f 
Application Servers Enable annotation processing options 
Clouds 
2 Cancel Anny an 


图 1-28 选中 Delegate to Javac 选 项 


Messages: Build 

Information: Kotlin: kotlinc-jvm 1.2.30 (JRE 1.8.0. 121-b15) 

Information: Builder "ajc" requested rebuild of module chunk "spring-aspects main" 
Information: java: Errors occurred while compiling module 'spring-oxm. test" 


» z| 9 
© 
o 
© Information: javac 1.8.0. 121 was used to compile java sources 
e 
e 
o 
o 





x 
Information: Modules "spring-web. main", "spring-orm main", "spring-build-src main", "spring-context test", "spring-messaging main" and 18 others were 
configuration/dependencies changes 
Information: 18/4/10 上 午 10:53 - Compilation completed with 59 errors and 2 warnings in 43s 81ms 
i ) Warning: Kotlin: Classpath entry points to a non-existent location: /Users/haojia/git/spring-framework/spring-core/build/libs/spring-cglib-repack-3.2.6.jar 


Warning: Kotlin: Classpath entry points to a non-existent location: /Users/haojia/git/spring-framework/spring-core/build/libs/spring-objenesis-repack-2.6.j 
/git/spring-framework/spring-beans/src/test/java/org/springframework/tests/sample/beans/IndexedTestBean.java 
/git/spring-framework/spring-context/src/test/java/org/springframework/aop/framework/JdkDynamicProxyTests.java 

3^. [Users[haojia/git/spring-framework/spring-oxm/src/test/java/org/springframework/oxm/jaxb/Jaxb2UnmarshallerTests.java 

a [Users[haojia/git/spring-framework/spring-oxm/src/test/java/org/springframework/oxm/jaxb/Jaxb2MarshallerTests.java 
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è 
$ 
8 
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Af 9: Version Control fi Termina! Į Build Å Problems Wh Java Enterprise ø Spring | =|Q:Messages “> 6: TODO 


图 1-29 ”编译 器 改 为 Ajc 


全 此 ， 我 们 已 经 完成 了 整个 Spring 的 环境 搭建 
工作 ， 还 有 一 些 单 测 闫 的 错误 已 经 不 影响 源码 阅 
Bh, WAY BUR TN TRAM, MPS, ASR 
sce Ay AH ORE. 


"Rast Aare ASL YL 


源码 分 析 是 一 件 非 常 煎熬 且 极 具 挑战 性 的 任 
务 ， 你 准备 好 开始 战斗 了 吗 ? 

在 正式 开始 分 析 Spring 源 码 之 前 ， 我 们 有 必要 
先 来 回顾 一 下 Spring 中 最 简单 的 用 法 ， 尽 管 我 相信 
您 已 经 对 这 个 例子 非常 熟悉 了 。 


2.1 容器 基本 用 法 


bean 是 Spring 中 最 核心 的 东西 ， 因 为 Spring 就 像 
是 个 大 水 桶 ， 而 bean 就 像 是 容器 中 的 水 ， 水 桶 脱离 
了 水 便 也 没什么 用 处 了 ， 那 么 我 们 先 看 看 bean 的 定 


bu 








public class MyTestBean { 
private String testStr = "testStr"; 


public String getTestStr() (1 
return testStr; 


j 


public void setTestStr(String testStr) { 
this.testStr = testStr; 


”| 

这 么 看 来 bean 并 没有 任何 特别 之 处 ， 的 确 ， 
Spring 的 目的 就 是 让 我 们 的 bean 能 成 为 一 个 纯粹 的 
POJO， 这 也 是 Spring 所 奶 求 的 。 接 下 来 看 看 配置 文 
件 : 








«?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.Springframework.org/schema/ 

beans http://www. 

Springframework.org/schema/beans/Spring-beans.xsd"> 


<bean id="myTestBean" class="bean.MyTestBean"/> 


</beans> 








在 上 面 的 配置 中 我 们 看 到 了 bean 的 声明 方式 ， 
KE Spring P bean h] TA E X ENM JR TERK x RA] 
业务 的 各 种 应 用 ， 但 是 我 们 只 要 声明 成 这 样 ， 基 本 
上 惑 已 经 可 以 满足 我 们 的 大 多 数 应 用 了 。 好 了 ， 你 
可 能 党 得 还 有 什么 ， 但 是 ， 真 没 了 ，Spring 的 入 门 
示例 到 这 里 已 经 结束 ， 我 们 可 以 写 测 试 代 码 测 试 
Y 











@SuppressWarnings("deprecation" ) 
public class BeanFactoryTest { 


@Test 
public void testSimpleLoad(){ 
BeanFactory bf = new XmlBeanFactory(new ClassPa 


thResource("beanFactoryTest.xml")); 
MyTestBean bean=(MyTestBean) bf.getBean("myTestBea 
n"); 
assertEquals("testStr",bean.getTestStr()); 
} 


} 





相信 聪明 的 读者 会 很 快 看 到 我 们 期 望 的 结 
在 Eclipse 中 显示 了 Green Bar. 


直接 使 用 BeanFactory 作 为 容器 对 于 Spring 的 使 
用 来 说 并 不 多 见 ， 甚 至 是 甚 少 使 用 ， 因 为 在 企业 级 
的 应 用 中 大 多 数 都 会 使 用 的 是 
ApplicationContext《〈 后 续 草 节 我 们 会 介绍 它们 之 间 
的 区 别 ) ， 这 里 只 是 用 于 测试 ， 让 读者 更 快 更 好 地 
分 析 Spring 的 内 部 原理 。 


OK， 我 们 又 复习 了 一 过 Spring， 你 是 不 是 会 很 
AJ We? 这 样 的 小 例子 没有 任何 挑战 性 。 嗯 ， 确 
实 ， 这 样 的 使 用 是 过 于 简单 了 ， 但 是 本 书 的 目的 并 
不 是 介绍 如 何 使 用 Spring， 而 是 帮助 您 更 好 地 了 解 
Spring 的 内 部 原理 。 旋 者 可 以 目 己 先 想 想 ， 上 面 的 
一 句 简 单 代 人 码 都 执行 了 什么 样 的 逻辑 昵 ? 这 样 一 句 
简单 代码 其 实在 Spring 中 执行 了 太 多 太 多 的 逻辑 ， 
即使 作者 用 半 本 书 的 文字 也 只 能 介绍 它 的 大 致 原 
理 。 那 么 就 让 我 们 快速 地 进入 分 析 状 态 吧 。 























2.2 ”功能 分 析 


现在 我 们 可 以 来 好 好 分 析 一 下 上 面 测试 代码 的 
功能 ， 来 探索 上 面 的 测试 代码 中 Spring 乞 葛 帮 助 我 
们 完成 了 什么 工作 ? 不 管 之 前 你 是 售 使 用 过 
Spring， 当 然 ， 你 应 该 使 用 过 的 ， 毕 竞 本 书面 问 的 
征 对 Spring 有 一 定 使 用 经 验 的 读者 ， 你 都 应 该 能 猜 











CARA] 


e 该 取 配 置 文件 beanFactoryTest.xml。 
e 根据 beanFactoryTest.xml 中 的 配置 找到 对 应 的 类 


的 配置 ， 并 实例 化 。 

。 调用 实例 化 后 的 实例 。 

为 了 更 清楚 地 描述 ， 作 者 临时 画 了 设计 类 图 ， 
如 图 2-1 所 示 ， 如 果 想 完成 我 们 预想 的 功能 ， 至 少 
需要 3 个 类 。 

。ConfigReader: 用 于 谈 取 及 验证 配置 文件 。 我 们 
要 用 配置 文件 里 面 的 东西 ， 当 然 首先 要 做 的 束 
是 谈 取 ， 然 后 放置 在 内 存 中 。 

e ReflectionUtil: 用 于 根据 配置 文件 中 的 配置 进行 
反射 实例 化 。 比 如 在 上 例 中 beanFactoryTest.xml 
出 现 的 <bean id="myTestBean" 

















class="bean.MyTestBean"/>， 我 们 就 可 以 根据 
bean.MyTestBean 进 行 实例 化 。 
e App: 用 于 完成 整个 逻辑 的 串联 。 





图 2-1 ”最 简单 的 Spring 功能 架构 
按照 原始 的 思维 方式 ， 整 个 过 程 无 非 如 此 ， 但 


是 作为 一 个 风 雄 世界 的 优秀 源码 真 的 束 这 么 人 简 早 
[i 9 





23 工程 搭建 


个 如 我 们 首 和 匈 大 致 看 看 Spring 的 源码 。 在 
Spring 源码 中 ， 用 于 实现 上 面 功能 的 是 
org.Springframework.beans.jar， 我 们 看 源码 的 时 候 
要 打开 这 个 工程 ， 如 果 我 们 只 使 用 上 面 的 功能 ， 那 
残 没 有 必要 引入 Spring 的 其 他 更 多 的 包 ， 当 然 Core 
是 必需 的 ， 还 有 些 依赖 的 包 如 图 2-2 所 示 。 





E Source | L> Projects | BB Libraries | So Order and Export 











JARs and class folders on the build path: 











bd com.springsource.javax.el-1.0.0 jar - org.springframework.beans/lib | Add JARS... 
com.springs 
































oo com.springsource.javax.inject-1.0.0,jar - org.springframework.beans/lib 

E com.springsource.net.sf.cglib-2.2.0,jar - org.springframework.beans/lib Add External JARs... 

E com.springsource.org.apache.commons.logging-1.1.Ljar - org.springframework.beans; RA 

Ea com.spring g.apache.log4j-1.2.16,ar - org.springframework.beans/lib 

Gà com.springsource.org.easymock-2.5.1 jar - org.springframework.beans/lib Add Library... 

bw com.springsource.org.hamcrest-1.1.0 jar - org.springframework.beans/lib 

= UN j z 2 Add Class Folder... 

að com.springsource.org.junit-4.9.0.jar - org.springframework.beans/lib 

BA JRE System Library [jdk] Add External Class Folder... 














图 2-2 ”Spring 测试 类 依赖 的 JAR 


引入 依赖 的 JAR 消 除 挥 所 有 编译 错误 后 ， 终 于 
可 以 看 源码 了 。 或 许 你 已 经 知道 了 答案 ，Spring 居 
然 用 了 N 多 代码 实现 了 这 个 看 似 很 简单 的 功能 ， 那 
么 这 些 代码 都 是 做 什么 用 的 呢 ? Spring 在 架构 或 者 
编码 的 时 候 又 是 如 何 考 虑 的 呢 ? SER. iE] 
踏 上 研读 Spring 源码 的 征程 。 


2.4 Spring 的 结构 组 成 


我 们 首先 尝试 梳理 Spring 的 框架 结构 ， 从 全 局 
的 角度 了 解 Spring 的 结构 组 成 。 


2.4.1 beans 包 的 层级 结构 


作者 认为 阅读 源码 的 最 好 方法 是 通过 示例 跟着 
操作 一 再 ， 虽 然 有 时 候 或 者 说 大 多 数 时候 会 被 复杂 
的 代码 绕 来 绕 去 ， 统 到 最 后 已 经 不 知道 自己 里 在 何 
处 了 ， 但 是 ， 如 果 配 以 UML 还 是 可 以 搞定 的 。 作 者 
就 是 按照 日 己 的 思路 进行 分 析 ， 并 配合 必要 的 
UML, FRIA lal Pea WER EE. 


我 们 先 看 看 整个 beans 工 程 的 源码 结构 ， 如 图 2- 
BAAR o 


beans 包 中 的 各 个 源码 包 的 功能 如 下 。 


src/main/java 用 于 展现 Spring 的 主要 逻辑 。 
src/main/resources 用 于 存放 系统 的 配置 文件 。 
src/testUjava 用 于 对 主要 尿 辑 进行 单元 测试 。 
src/test/resources 用 于 存放 测试 用 的 配置 文件 。 


4 322 org.springframework.beans 
$ c/main/] 














má JRE System Library [jdk] 
mi, Referenced Libraries 


3 template.mf 


图 2-3 ”beans 工 程 的 源码 结构 


2.4.2 ”核心 类 介绍 


通过 beans 工 程 的 结构 介绍 ， 我 们 现在 对 beans 
的 工程 结构 有 了 初步 的 认识 ， 但 是 在 正式 开始 源码 
分 析 之 前 ， 有 必要 了 解 Spring 中 核心 的 两 个 类 。 














1. DefaultListableBeanFactory 


XmlBeanFactory4*7K Á 
DefaultListableBeanFactory, 而 
DefaultListableBeanFactory 是 整个 bean 加 载 的 核心 部 
分 ， 是 Spring 注册 及 加 载 bean 的 默认 实现 ， 而 对 于 
XmlBeanFactory 与 DefaultListableBeanFactory 不 同 的 
地 方 其实 是 在 XmlBeanFactory 中 使 用 了 目 定 义 的 
XML 读 取 器 XmlBeanDefinitionReader， 实 现 了 个 性 
化 的 BeanDefinitionReader 读 取 ， 
DefaultListableBeanFactory 继 承 了 
AbstractAutowireCapableBeanFactory 并 实现 了 
ConfigurableListableBeanFactory 以 及 
BeanDefinitionRegistry 接 口 。 图 2-4 是 
ConfigurableListableBeanFactory 的 层次 结构 图 ， 图 
2-5 是 相关 类 图 。 











DefaultListableB eanFactory - org.springframework.beans factory.support 
* (81) te E ~ 
4 K9 DefaultListableBeanFactory 
4 (9^ AbstractAutowireCapableB eanFactory 
4 (9^ AbstractBeanFactory 
4 9^ FactoryBeanRegistrySupport 
4 (9 DefaultSingletonB eanRegistry 
4 (9 SimpleAliasRegistry 
(9 Object 
@ AliasRegistry 
@ SingletonBeanRegistry 








4 © ConfigurableBeanFactory 
4 €) HierarchicalB eanFactory 
@  BeanFactory 
@ SingletonBeanRegistry 
4 $3 AutowireCapableBeanFactory 
@ BeanFactory 
4 @ BeanDefinitionRegistry 
@ AliasRegistry 
4 € ConfigurableListableBeanFactory 
4 $3 AutowireCapableBeanFactory 
@ BeanFactory 
4 @ ConfigurableBeanFactory 
4 @ HierarchicalBeanFactory 
@ BeanFactory 
© SingletonBeanRegistry 
4 @ ListableBeanFactory 
@ BeanFactory 
O Serializable 


图 2-4 ”ConfigurableListableBeanFactory 的 层次 结构 图 


«Java Class» 
© DefaultListableBeanFactoi ry 














a «Java Interface» 
© AbstractAutowireCapableBeanFacto: ry @ ConfigurableListableBeanFacto: ry 
| Q AbstractBeanFactoi ry | Q AutowireCapableBeanFactory 
与 -一 一 m — 
A «Java Interface» al «Java Class» 
@ BeanDefinitionRegistry |. Q FactoryBeanRegistrySupport © ConfigurableBeanFactoi ry @ ListableBeanFacto: ry | 
| | 
a «Java Class» a «Java Interface» | 
| © DefaultSingletonBeanRegistry | @ HierarchicalBeanFactory 
z 
Java Class» «Java Interface» Flava I 
© SimpleAliasRegistry |.  SingletonBeanRegistry @ BeanFactory 











Al2-5 Aas NAAR 


从 上 面 的 类 图 以 及 层次 结构 图 中 ， 我 们 可 以 很 
清晰 地 从 全 局 角度 了 解 DefaultListableBean- Factory 
的 脉络 。 如 果 读 者 没有 了 解 过 Spring 源码 可 能 对 上 
面 的 类 图 不 是 很 理解 ， 不 过 没关系 ， 通 过 后 续 有 的 学 
习 ， 你 会 逐渐 了 解 每 个 类 的 作用 。 那 么 ， 让 我 们 先 
简单 地 了 解 图 2-5 中 各 个 类 的 作用 。 














e AliasRegistry: 定义 对 alias 的 简单 增删 改 等 操 


(ee 

SimpleAliasRegistry: 主要 使 用 map 作 为 alias 的 
缓存 ， 并 对 接口 AliasRegistry 进 行 实 现 。 
SingletonBeanRegistry: 定义 对 单 例 的 注册 及 获 
B. 

BeanFactory: 定义 获取 bean 及 bean 的 各 种 属 

性 。 

DefaultSingletonBeanRegistry: 对 接口 
SingletonBeanRegistry 各 函数 的 实现 。 
HierarchicalBeanFactory: 继承 BeanFactory， 也 
束 是 在 BeanFactory 定 义 的 功能 的 基础 上 增加 了 
对 parentFactory 的 支持 。 

BeanDefinitionRegistry: 定义 对 BeanDefinition 的 
各 种 增删 改 操 作 。 

FactoryBeanRegistrySupport: 在 
DefaultSingletonBeanRegistry 基 础 上 增加 了 对 
FactoryBean 的 特殊 处 理 功 能 。 
ConfigurableBeanFactory: 提供 配置 Factory 的 各 
种 方法 。 

ListableBeanFactory: 根据 各 种 条 件 获 取 bean 的 
配置 清单 。 

AbstractBeanFactory: 综合 
FactoryBeanRegistrySupport 和 
ConfigurableBeanFactory 的 功能 。 
AutowireCapableBeanFactory: 提供 创建 bean、 
自动 注入 、 初 始 化 以 及 应 用 bean 的 后 处 理 器 。 











e AbstractAutowireCapableBeanFactory: 综合 
AbstractBeanFactory 并 对 接口 Autowire Capable 
BeanFactory 进 行 实现 。 

e ConfigurableListableBeanFactory: BeanFactory 配 
置 清 单 ， 指 定 忽 略 类 型 及 接口 等 。 

e DefaultListableBeanFactory: 综合 上 面 所 有 功 
能 ， 主 要 是 对 bean 注 册 后 的 处 理 。 


XmlBeanFactory 对 DefaultListableBeanFactory 类 
进行 了 扩展 ， 主 要 用 于 从 XML 文 档 中 读 取 
BeanDefinition， 对 于 注册 及 获取 bean 都 是 使 用 从 父 
类 DefaultListableBeanFactory 继 承 的 方法 去 实现 ， 

而 唯 独 与 父 类 不 同 的 个 性 化 实现 融 是 增加 了 
XmlBeanDefinitionReader 类 型 的 reader 必 性。 在 
XmlBeanFactory 中 主要 使 用 reader 属 性 对 资源 文件 
进行 谈 取 和 注册 。 





2. XmlBeanDefinitionReader 


XML 配置 文件 的 恋 取 是 Spring 中 重要 的 功能 ， 
因为 Spring 的 大 部 分 功能 都 是 以 配置 作为 切入 点 
的 ， 那 么 我 们 可 以 从 XmlBeanDefinitionReader 中 本 
理 一 下 资源 文件 读 取 、 解 析 及 注册 的 大 致 脉络 ， 首 
先 我 们 看 看 各 个 类 的 功能 。 


e ResourceLoader: 定义 资源 加 载 需 ， 主 要 应 用 于 








根据 给 定 的 资源 文件 地 址 返回 对 应 的 Resource。 
e BeanDefinitionReader: 主要 定义 资源 文件 读 取 
并 转换 为 BeanDefinition 的 各 个 功能 。 
EnvironmentCapable: 定义 获取 Environment 方 
iE. 
DocumentLoader: 定义 从 资源 文件 加 载 到 转换 
为 Document 的 功能 。 
AbstractBeanDefinitionReader: 对 
EnvironmentCapable. BeanDefinitionReader2S 4E 
义 的 功能 进行 实现 。 
e BeanDefinitionDocumentReader: 定义 读 取 
Docuemnt 并 注册 BeanDefinition 功 能 。 
e BeanDefinitionParserDelegate: 定义 解析 Element 
的 各 种 方法 。 


经 过 以 上 分 析 ， 我 们 可 以 梳理 出 整个 XML 配 置 
文件 读 取 的 大 致 流程 ， 如 图 2-6 所 示 ， 在 
XmlBeanDifinitionReader 中 主要 包含 以 下 几 步 的 处 
理 。 
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1. 通过 继承 自 AbstractBeanDefinitionReader 中 
的 方法 ， 来 使 用 ResourLoader 将 资源 文件 路 径 转 换 
为 对 应 的 Resource 文 件 。 


2. 通过 DocumentLoader 对 Resource 文 件 进行 转 
换 ， 将 Resource 文 件 转 换 为 Document 文 件 。 


3. 通过 实现 接口 
BeanDefinitionDocumentReader 的 
DefaultBeanDefinitionDocumentReader 类 对 
Document 进 行 解析 ， 并 使 用 
BeanDefinitionParserDelegate 对 Element 进 行 解析 。 


2.5 asl) 2 Fi XmlBeanFactory 


4r, Bix PRT CAM Spring 4 as nea 
了 大 致 的 了 解 ， 尽 管 你 可 能 还 很 迷糊 ， 但 是 不 要 
紧 ， 接 下 来 我 们 会 详细 探索 每 个 步骤 的 实现 。 再 次 
重申 一 下 人 代码， 我 们 接 下 来 要 深入 分 析 以 下 功能 的 
代码 实现 : 


BeanFactory bf = new XmlBeanFactory(new ClassPathResource("b 
eanFactoryTest.xml")); 


通过 XmlBeanFactory 初 始 化 时 友 图 (如 图 2-7 所 
示 ) 我 们 来 看 一 看 上 面 代码 的 执行 人 逻辑 。 


时 友 图 从 BeanFactoryTest 测 试 类 开始 ， 通 过 时 
序 图 我 们 可 以 一 目 了 然 地 看 到 整个 逻辑 处 理 顺序 。 
在 测试 的 BeanFactoryTest 中 首先 调用 
ClassPathResource 的 构造 函数 来 构造 Resource 资 源 
文件 的 实例 对 象 ， 这 样 后 续 的 资源 处 理 束 可 以 用 
Resource 提 供 的 各 种 服务 来 操作 了 ， 当 我 们 有 了 
Resource 后 就 可 以 进行 XmlBeanFactory 的 初始 化 
了 。 那 么 Resource 资 源 是 如 何 封 装 的 呢 ? 





El 
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图 2-7 XmlBeanFactory 人 初始 化 时 序 图 
2.5.1 配置 文件 封装 


Spring 的 配置 文件 恋 取 是 通过 


ClassPathResource 进 行 封装 的 ， 如 new 
ClassPathResource ("beanFactoryTest.xml"), Jj 
ClassPathResource 完 成 了 什么 功能 呢 ? 


在 Java 中 ， 将 不 同 来 源 的 资源 抽象 成 URL， 通 
过 注册 不 同 的 handler CURLStreamHandler) 来 处 理 
不 同 来 源 的 资源 的 读 取 逻辑 ， 一 般 handler 的 类 型 使 
AAA TA aR CPIM, Protocol) 来 识别 ， 
如 “file:”“http:”“jar” 等 ， 然 而 UREL 没 有 默认 定义 相 
对 Classpath 或 ServletContext 等 资源 的 handler， 虽 然 
可 以 注册 自己 的 URLStreamHandler 来 解析 特定 的 
URLEIZE CHX) ， 比 如 “classpath:”， 然 而 这 需要 
了 解 URL 的 实现 机 制 ， 而 且 URL 也 没有 提供 基本 的 
方法 ， 如 检查 当前 资源 是 否 存 在 、 检 查 当 前 资源 是 
否 可 读 等 方法 。 因 而 Spring 对 其 内 部 使 用 到 的 资源 
实现 了 自己 的 抽象 结构 : Resource 接 口 封装 底层 资 
源 。 

















public interface InputStreamSource { 
InputStream getInputStream() throws IOException; 


} 
public interface Resource extends InputStreamSource { 
boolean exists(); 
boolean isReadable(); 
boolean isOpen(); 
URL getURL() throws IOException; 
URI getURI() throws IOException; 
File getFile() throws IOException; 
long lastModified() throws IOException; 
Resource createRelative(String relativePath) throws IOExcep 
tion; 
String getFilename(); 


String getDescription(); 
} 


InputStreamSource 4% fF fuf 8&3 [2] InputStream 
的 类 ， 比 如 File、Classpath 下 的 资源 和 Byte Array 
等 。 它 只 有 一 个 方法 定义 : getInputStream()， 访 方 
法 返回 一 个 新 的 InputStream 对 象 。 


Resource 接 口 抽象 了 所 有 Spring 内 部 使 用 到 的 
底层 资源 : File, URL. Classpath. 56, Exe 
义 了 3 个 判断 当前 资源 状态 的 方法 : 存在 性 
(Cexists) 、 可 读 性 〈isReadable) 、 是 否 处 于 打开 
状态 GsOpen) 。 男 外 ，Resource 接 口 还 提供 了 不 
同 资源 到 URL、URI、File 类 型 的 转换 ， 以 及 获取 
lastModified 属 性 、 文 件 名 (不 带路 笃信 息 的 文件 
名 ，getFilename()) 的 方法 。 为 了 便于 操作 ， 
Resource 还 提供 了 基于 当前 资源 创建 一 个 相对 资源 
的 方法 : createRelative()。 在 错误 处 理 中 需要 详细 
地 打印 出 错 的 资源 文件 ， 因 而 Resource 还 提供 了 
getDescription() 方 法 用 来 在 错误 处 理 中 打印 信息 。 


对 不 同 来 源 的 资源 文件 都 有 相应 的 Resource 实 
现 : 文件 (FileSystemResource) 、Classpath 资 源 
(ClassPathResource) 、URL 资 源 
(UrlResource) 、InputStream 资 源 
(InputStreamResource) 、Byte 数 组 











(ByteArrayResource) 等 。 相 关 类 疼 如 图 2-8 所 示 。 
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图 2-8 ”资源 文件 处 理 相 关 类 图 
在 日 常 的 开发 工作 中 ， 资 源 文 件 的 加 载 也 是 经 





常用 到 的 ， 可 以 直接 使 用 Spring 提 供 的 类 ， 比 如 在 
希望 加 载 文 件 时 可 以 使 用 以 下 代码 : 


Resource resource=new ClassPathResource("beanFactoryTest.xm1"); 


InputStream inputStream-resource.getInputStream(); 








得 到 inputStream 后 ， 我 们 就 可 以 按照 以 前 的 开 
发 方式 进行 实现 了 ， 并 且 我 们 可 以 利用 Resource 及 
其 子 类 为 我 们 提供 的 诸多 特性 。 





有 了 Resource 接 口 便 可 以 对 所 有 资源 文件 进行 
统一 处 理 。 人 至 于 实现 ， 其 实 是 非常 简单 的 ， 以 
getInputStream 为 例 ，ClassPathResource 中 的 实现 方 
式 便 是 通过 class 或 者 classLoader 提 供 的 的 层 方法 进 
行 调 用 ， 而 对 于 FileSystemResource 的 实现 其 实 更 简 
单 ， 直 接 使 用 FileInputStream 对 文件 进行 实例 化 。 

















ClassPathResource.java 


if (this.clazz != null) { 
is = this.clazz.getResourceAsStream(this.path); 
jelse ( 
is - this.classLoader.getResourceAsStream(this.pat 





FileSystemResource.java 


public InputStream getInputStream() throws IOException { 
return new FileInputStream(this.file); 


j 


当 通 过 Resource 相 关 类 完成 了 对 配置 文件 进行 
封装 后 配置 文件 的 读 取 工作 就 全 权 交 给 
XmlBeanDefinitionReader 来 处 理 了 。 


了 解 了 Spring 中 将 配置 文件 封装 为 Resource 类 
型 的 实例 方法 后 ， 我 们 就 可 以 继续 探寻 
XmlBeanFactory 的 初始 化 过 程 了 ，XmlBeanFactory 














的 初始 化 有 若干 办 法 ，Spring 中 提供 了 很 多 的 构造 
函数 ， 在 这 里 分 析 的 是 使 用 Resource 实 例 作为 构造 
图 数 参 数 的 办 法 ， 代 码 如 下 : 


XmlBeanFactory.java 


public XmlBeanFactory(Resource resource) throws BeansException 





// 调 用 XmlBeanFactory (Resource, BeanFactory) 构造 方法 
this 


(resource, null); 


J 





构造 函数 内 部 再 次 调用 内 部 构造 函数 : 


//parentBeanFactory 为 父 类 BeanFactory 用 于 factory 合 并 ， 可 以 为 空 
public XmlBeanFactory(Resource resource, BeanFactory parentBean 
Factory) throws 
BeansException ( 
super(parentBeanFactory); 
this.reader.loadBeanDefinitions 





(resource); 


j 





Er eg HR FR 
this.reader.loadBeanDefinitions(resource) 才 是 资源 加 
载 的 真正 实现 ， 也 是 我 们 分 析 的 重点 之 一 。 我 们 可 
以 看 到 时 序 网 中 提 到 的 XmlBeanDefinitionReader 加 
aX AGE ETE IX BSE RMA, (A ETE 
XmlBeanDefinitionReader 加 载 数据 前 还 有 一 个 调用 





父 类 构造 函数 初始 化 的 过 程 : 
super(parentBeanFactory)， 跟 踪 代 人 码 到 父 类 
AbstractAutowireCapableBeanFactory 的 构造 函数 


AbstractAutowireCapableBeanFactory.java 


public AbstractAutowireCapableBeanFactory() { 
super(); 
ignoreDependencyInterface(BeanNameAware.class); 
ignoreDependencyInterface(BeanFactoryAware.class); 


ignoreDependencyInterface(BeanClassLoaderAware.class); 





ix E A VES I ignoreDependencyInterface77 
法 。ignoreDependencyInterface 的 主要 功能 是 忽略 给 
定 接 口 的 自动 装配 功能 ， 那 么 ， 这 样 做 的 目的 古 什 
AE? 会 产生 什么 样 的 效果 呢 ? 


举例 来 说 ， 当 A 中 有 属性 B， 那 么 当 Spring 在 获 
取 A 的 Bean 的 时 候 如 果 其 属性 B 还 没有 初始 化 ， 那 
么 Spring 会 目 动 初始 化 B， 这 也 是 Spring 中 提供 的 一 
个 重要 特性 。 但 是 ， 某 些 情况 下 ，B 不 会 被 礼 始 
化 ， 其 中 的 一 种 情况 就 是 B 实 现 了 BeanNameAware 
接口 。Spring 中 是 这 样 介绍 的 : 目 动 装配 时 忽略 给 
定 的 依赖 接口 ， 典 型 应 用 是 通过 其 他 方式 解析 
Application 上 下 文 注册 依赖 ， 类 似 于 BeanFactory 通 
过 BeanFactoryAware 进 行 注入 或 者 








ApplicationContextili if ApplicationContextA waret 
YEA. 


2.5.2 Jli£X Bean 


ZH He FAJE XmlBeanFactory tit K BF 158] FA 
了 XmlBeanDefinitionReader 关 型 的 reader 属 性 提供 的 
方法 this.reader.loadBeanDefinitions(resource)， 而 这 
句 代 码 则 是 整个 资源 加 载 的 切入 点 ， 我 们 先 来 看 看 
这 个 方法 的 时 序 图 ， 如 图 2-9 所 示 。 
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图 2-9 _ loadBeanDefinitions & 247 IN Fr Eg 
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了 这 么 半天 还 没有 真正 地 切入 正题 ， 比 如 加 载 XML 
文档 和 人 解析 注册 Bean， 一 直 还 在 做 准备 工作 。 我 们 





根据 上 面 的 时 序 图 来 分 析 一 下 这 里 究竟 在 准备 什 
A? 从 上 面 的 时 序 图 中 我 们 壬 试 梳理 整个 的 处 理 过 
程 如 下 。 


1. 封装 资源 文件 。 当 进入 
XmlBeanDefinitionReader 后 首先 对 参数 Resource 使 
用 EncodedResource 类 进行 封装 。 





2. 获取 输入 流 。 从 Resource 中 获取 对 应 的 
InputStream 并 构造 InputSource。 


3. 通过 构造 的 InputSource 实 例 和 Resource 实 例 
ke Wi] HA ER 2 doLoadBeanDefinitions . 


我 们 来 看 一 下 loadBeanDefinitions 函 数 具 体 的 
实现 过 程 。 


public int loadBeanDefinitions(Resource resource) throws BeanDe 
finitionStoreException { 
return loadBeanDefinitions(new EncodedResource 


(resource)); 





那么 EncodedResource 的 作用 是 什么 昵 ? 通过 名 
称 ， 我 们 可 以 大 人 致 推断 这 个 类 主要 是 用 于 对 资源 文 
件 的 编码 进行 处 理 的 。 其 中 的 主要 逻辑 体现 在 
getReader() 方 法 中 ， 当 设置 了 编码 属性 的 时 候 





Spring 会 使 用 相应 的 编码 作为 输入 流 的 编码 。 


public Reader getReader() throws IOException { 
if (this.encoding !- null) ( 
return new InputStreamReader(this.resource.getInpu 
tStream(), this.encoding); 


else ( 
return new InputStreamReader(this.resource.getInpu 
tStream()); 
} 


J 





上 面 代 人 码 构 造 了 一 个 有 编码 (encoding) 的 
InputStreamReader。 当 构造 好 encodedResource 对 象 
后 ， 再 次 转 入 了 可 复 用 方法 loadBeanDetfinitions(new 


EncodedResource(resource))。 


这 个 方法 内 部 才 是 真正 的 数据 准备 阶段 ， 也 就 
是 时 序 图 所 插 述 的 多 辑 : 








public int loadBeanDefinitions(EncodedResource encodedResource) 
throws BeanDefinitionStoreException { 
Assert.notNull(encodedResource, "EncodedResource must 
not be null"); 
if (logger.isInfoEnabled()) { 
logger.info("Loading XML bean definitions from " + 
encodedResource. 
getResource( )); 








} 
// 通 过 属性 来 记录 已 经 加 载 的 资源 
Set«EncodedResource» currentResources = this.resources 
CurrentlyBeingLoaded.get(); 
if (currentResources == null) { 
currentResources = new HashSet<EncodedResource>(4) 





this.resourcesCurrentlyBeingLoaded.set(currentReso 


urces); 

} 

if (!currentResources.add(encodedResource)) { 

throw new BeanDefinitionStoreException( 
"Detected cyclic loading of " + encodedRes 

ource + " - check your import definitions!"); 

} 

try { 


// 从 encodedResource 中 获取 已 经 封装 的 Resource 对 象 并 再 次 从 Resource 
中 获取 其 中 的 ijnputStream 
InputStream inputStream = encodedResource.getResou 
rce().getInputStream(); 
try { 
//InputSource 这 个 类 并 不 来 自 于 Spring， 它 的 全 路 径 是 org ,xm 
l.sax.InputSource 
InputSource inputSource - new InputSource(inputStr 
eam); 
if (encodedResource.getEncoding() !- null) { 
inputSource.setEncoding(encodedResource.getEnc 
oding()); 





ii 
// REHA TEZ aD 


return doLoadBeanDefinitions 











(inputSource, encodedResource.getResource()); 


} 
finally { 
// 关 闭 输入 流 
inputStream.close(); 
j 


} 
catch (IOException ex) { 


throw new BeanDefinitionStoreException( 
"IOException parsing XML document from " + 
encodedResource.getResource(),ex); 


} 
finally { 
currentResources.remove(encodedResource); 
if (currentResources.isEmpty()) { 
this.resourcesCurrentlyBeingLoaded.remove(); 
} 
} 
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入 的 resource 参 数 做 封装 ， 目 的 是 考虑 到 Resource 可 
能 存在 编码 要 求 的 情况 ， 其 次 ， 通 过 SAX 读 取 XML 
文件 的 方式 来 准备 InputSource 对 象 ， 最 后 将 准备 的 
数据 通过 参数 传 入 真正 的 核心 处 理 部 分 
doLoadBeanDefinitions(inputSource, 
encodedResource.getResource()). 





protected int doLoadBeanDefinitions(InputSource inputSource, Re 
source resource) 
throws BeanDefinitionStoreException ( 
try { 
int validationMode - getValidationModeForResource 


(resource); 
Document doc - this.documentLoader.loadDocument 


( 
inputSource, getEntityResolver(), this.err 
orHandler, validationMode, isNamespaceAware()); 
return registerBeanDefinitions 


(doc, resource); 


catch (BeanDefinitionStoreException ex) ( 
throw ex; 


catch (SAXParseException ex) ( 
throw new XmlBeanDefinitionStoreException(resource 
.getDescription(), 
"Line " + ex.getLineNumber() + " in XML do 
cument from " + resource 
+ " is invalid", ex); 


} 
catch (SAXException ex) { 
throw new XmlBeanDefinitionStoreException(resource 
.getDescription(), 
"XML document from " + resource + " is inv 
alid", ex); 


catch (ParserConfigurationException ex) ( 
throw new BeanDefinitionStoreException(resource.ge 
tDescription(), 
"Parser configuration exception parsing XM 
L from " + resource,ex); 


} 
catch (IOException ex) { 
throw new BeanDefinitionStoreException(resource.ge 
tDescription(), 
"IOException parsing XML document from " + 
resource, ex); 


} 
catch (Throwable ex) { 
throw new BeanDefinitionStoreException(resource.ge 
tDescription(), 
"Unexpected exception parsing XML document 
from " + resource,ex); 


j 
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i 其 实 只 做 了 三 件 事 ， 这 三 件 事 的 每 一 件 都 必 不 
可 少 。 


e 获取 对 XML 文件 的 验证 模式 。 
e 加载 XML 文 件 ， 并 得 到 对 应 的 Document。 
。 根 据 返 回 的 Document 注 册 Bean 信 息 。 


这 3 个 步骤 文 撑 着 整个 Spring 容器 部 分 的 实现 ， 
尤其 是 第 3 步 对 配置 文件 的 解析 ， 池 和 辑 非常 的 复 
杂 ， 我 们 先 从 获取 XML 文件 的 验证 模式 讲 起 。 








2.6 ”获取 XML 的 验证 模式 


了 解 XML 文件 的 读者 都 应 该 知道 XML 文件 的 
验证 模式 保证 了 XML 文件 的 正确 性 ， 而 比较 常用 的 
验证 模式 有 两 种 ，DTD 和 XSD。 它 们 之 间 有 什么 区 
Fl We 2 


2.6.1 DTD SXSDIX Jj 


DTD (Document Type Definition) 即 文档 类 型 
定义 ， 是 一 种 XML 约束 模式 语言 ， 是 XML 文件 的 
验证 机 制 ， 属 于 XML 文件 组 成 的 一 部 分 。DTD 是 一 
种 保证 XML 文档 格式 正确 的 有 效 方法 ， 可 以 通过 比 
较 XMEL 文 要 和 DTD 文 件 来 看 文档 是 个 符合 规范 ， 元 
素 和 标签 使 用 是 否 正 确 。 一 个 DID 文档 包 含 : 元 
素 的 定义 规则 ， 元 素 间 关系 的 定义 规则 ， 元 素 可 使 
用 的 属性 ， 可 使 用 的 实体 或 符号 规则 。 


要 使 用 DTD 验 证 模式 的 时 候 需 要 在 XML 文件 
的 头 部 声明 ， 以 下 是 在 Spring 中 使 用 DTD 声 明 方 式 
的 代码 : 











<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE beans PUBLIC "-//Spring//DTD BEAN 2.0//EN" "http://ww 
w.Springframework.org/ 

dtd/ Spring-beans-2.0.dtd"> 


«/beans» 





而 以 Spring 为 例 ， 有 具体 的 Spring-beans-2.0.dtd 部 
分 如 下 : 


<!ELEMENT beans ( 
description?, 
(import | alias | bean)* 
) > 
<!ATTLIST beans default-lazy-init (true | false) "false"> 
<!ATTLIST beans default-merge (true | false) "false"> 
<!ATTLIST beans default-autowire (no | byName | byType | constr 


uctor |autodetect )"no"> 

<!ATTLIST beans default-dependency-check (none | objects | simp 
le | all) "none"> 

<!ATTLIST beans default-init-method CDATA #IMPLIED> 

<!ATTLIST beans default-destroy-method CDATA #IMPLIED> 





XML Schema 语言 就 是 XSD (XML Schemas 
Definition) o XML Schema 描述 了 XML 文档 的 结 
构 。 可 以 用 一 个 指定 的 XML Schema 来 验证 某 个 
XML 文档 ， 以 检查 该 XML 文档 是 否 符合 其 要 求 。 
文档 设计 者 可 以 通过 XML Schema 指定 XML 文档 所 
允许 的 结构 和 内 容 ， 并 可 据 此 检查 XML 文档 是 否 是 
有 效 的 。XML Schema 本 身 是 XML 文档 ， 它 符合 
XML 语法 结构 。 可 以 用 通用 的 XML 解析 器 解析 


s 





在 使 用 XML Schema 文档 对 XML 实例 文档 进行 

检验 ， 除 了 要 声明 名 称 空 间 外 Cxmins- 
http://www.Springframework.org/schema/beans) , if 
必须 指定 该 名 称 空间 所 对 应 的 XML Schema 文档 的 
存储 位 置 。 通 过 schemaLocation 属 性 来 指定 名 称 空 
间 所 对 应 的 XML Schema 文 档 的 存储 位 置 ， 它 包 合 
两 个 部 分 ， 一 部 分 古 名 称 空 间 的 URI， 男 一 部 分 就 
是 该 名 称 空间 所 标识 的 XML Schema 文件 位 置 或 
URL 地 址 

(xsi:schemaLocation-"http://www.springframework.c 
http://www. 
Springframework.org/schema/beans/Spring- 
beans.xsd) . 














<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xSi:schemaLocation="http://www.Springframework.org/schema/ 


beans 

http://www. Springframework.org/schema/beans/Spring-beans. 
xsd 
Ws 


</beans> 





Spring-beans-3.0.xsd 部 分 代码 如 下 : 





<?xml version="1.0" encoding="UTF-8" standalone="no"?> 


«xsd:schema xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsdz"http://www.w3.0rg/2001/XMLSchema" 
targetNamespace="http://www.Springframework.org/schema 

/beans"> 


«xsd:import namespace="http://www.w3.org/XML/1998/namespac 


e"/» 
<xsd:annotation> 
<xsd:documentation><! [CDATA[ 
|] ]></xsd:documentation> 
</xsd:annotation> 
<!-- base types --> 
<xsd:complexType name="identifiedType" abstract="true"> 
<xsd:annotation> 
<xsd:documentation><! [CDATA[ 
The unique identifier for a bean. The scope of the identif 
ier 


is the enclosing bean factory. 
|] ]></xsd:documentation> 
</xsd:annotation> 
<xsd:attribute name="id" type="xsd:ID"> 
<xsd:annotation> 
<xsd:documentation><! [CDATA[ 
The unique identifier for a bean. 
|] ]></xsd:documentation> 
</xsd:annotation> 
</xsd:attribute> 
</xsd:complexType> 


</xsd:schema> 





我 们 只 是 简单 地 介绍 一 下 XML 文件 的 验证 模式 
的 相关 知识 ， 目 的 在 m 续 知 识 的 理解 能 
有 连续 性 ， 如 果 对 XML 有 兴趣 的 读者 可 以 进一步 查 
HOS TEL. 











2.6.2 ”验证 模式 的 读 取 


了 解 了 DTD 与 XSD 的 区 别 后 我 们 再 去 分 析 
Spring 中 对 于 验证 模式 的 提取 吏 更 容易 理解 了 。 通 
过 之 前 的 分 析 我 们 锁定 了 Spring 通过 
getValidationModeForResource 方 法 来 获取 对 应 资源 
的 的 验证 模式 。 








protected int getValidationModeForResource(Resource resource) ( 
int validationModeToUse - getValidationMode(); 
// 如 果 手 动 指定 了 验证 模式 则 使 用 指定 的 验证 模式 
if (validationModeToUse !- VALIDATION AUTO) ( 
return validationModeToUse; 














l 
// 如 果 未 指定 则 使 用 自动 检测 


int detectedMode = detectValidationMode 





(resource); 
if (detectedMode != VALIDATION AUTO) { 
return detectedMode; 


j 
return VALIDATION XSD; 








方法 的 实现 其 实 还 是 很 简单 的 ， 无 非 是 如 果 议 
定 了 验证 模式 则 使 用 设 定 的 验证 模式 〈 可 以 通过 对 
调用 XmlBeanDefinitionReader 中 的 
setValidationMode 方 法 进行 设 定 ) ， 人 否则 使 用 目 动 
检测 的 方式 。 而 目 动 检测 验证 模式 的 功能 是 在 函数 
detectValidationMode 方 法 中 实现 的 ， 在 
detectValidationMode 函 数 中 又 将 目 动 检测 验证 模式 


的 工作 委托 给 了 专门 处 理 类 XmlValidationMode- 
Detector， 调 用 了 XmlVvalidationModeDetector 的 
validationModeDetector 方 法 ， 有 具体 代码 如 下 : 





protected int detectValidationMode(Resource resource) { 
if (resource.isOpen()) { 
throw new BeanDefinitionStoreException( 
"Passed-in Resource [" + resource + "] con 
tains an open stream: " + 
"cannot determine validation mode automati 
cally. Either pass in a Resource " + 
"that is able to create fresh streams, or 
explicitly specify the validationMode " + 
"on your XmlBeanDefinitionReader instance. 
"); 
} 


InputStream inputStream; 


try { 
inputStream - resource.getInputStream(); 


} 
catch (IOException ex) { 
throw new BeanDefinitionStoreException( 
"Unable to determine validation mode for [ 
" + resource + "]: 
cannot open InputStream. " + 
"Did you attempt to load directly from a S 


AX InputSource without specifying the " + 
"validationMode on your XmlBeanDefinitionR 


eader instance?", ex); 


Jj 


try { 
return this.validationModeDetector.detectValidatio 


nMode 
(inputStream); 


catch (IOException ex) { 
throw new BeanDefinitionStoreException("Unable to 
determine validation mode for [" + 
resource + "]: an error occurred whilst re 


ading from the 
InputStream.", ex); 


l 
} 





XmlValidationModeDetector.java 





public int detectValidationMode(InputStream inputStream) t 
hrows IOException { 
BufferedReader reader=new BufferedReader(new InputStre 
amReader(inputStream)); 
try { 
boolean isDtdValidated - false; 
String content; 
while ((content = reader.readLine()) !- null) { 
content = consumeCommentTokens(content); 
// 如 果 读 取 的 行 是 空 或 者 是 注释 则 略 过 
if (this.inComment || !StringUtils.hasText(con 





tent)) { 
continue; 


if (hasDoctype 


(content)) { 
isDtdValidated - true; 
break; 


} 
// 读 取 到 < 开始 符号 ， 验 证 模式 一 定 会 在 开始 符号 之 前 
if (hasOpeningTag(content)) ( 

break; 








} 
} 
return (isDtdValidated ? VALIDATION_DTD : VALIDATI 
ON_XSD); 


catch (CharConversionException ex) { 
// Choked on some character encoding... 
// Leave the decision up to the caller. 
return VALIDATION AUTO; 

y 

finally { 
reader.close(); 


j 


private boolean hasDoctype(String content) { 
return (content.indexOf(DOCTYPE) » -1); 


j 





只 要 我 们 理解 了 XSD 与 DTD 的 使 用 方法 ， 理 解 
上 面 的 代码 应 该 不 会 太 难 ，Spring 用 来 检测 验证 模 
式 的 办 法 就 是 判断 是 否 包 含 DOCTYPE， 如 果 包 含 
WLXEDTD, m EXSD. 


2.7 ”获取 Document 


经 过 了 验证 模式 准备 的 步 又 就 可 以 进行 
Document 加 载 了 ， 同 样 XmlBeanFactoryReader 关 对 
于 文档 读 取 并 没有 杀 力 杀 为 ， 而 是 委托 给 了 
DocumentLoader 去 执行 ， 这 里 的 DocumentLoader 是 
个 接口 ， 而 真正 调用 的 是 DefaultDocumentLoader， 
解析 代码 如 下 : 








DefaultDocumentLoader.java 





public Document loadDocument(InputSource inputSource, EntityRes 
olver entityResolver, 
ErrorHandler errorHandler, int validationMode, boolean 
namespaceAware) throws Exception ( 


DocumentBuilderFactory factory - createDocumentBuilder 
Factory(validationMode, namespaceAware); 
if (logger.isDebugEnabled()) { 

logger.debug("Using JAXP provider [" + factory.get 


Class().getName()+"]"); 
} 


DocumentBuilder builder = createDocumentBuilder(factor 
y, entityResolver, 
errorHandler); 

return builder.parse(inputSource); 


Jj 





对 于 这 部 分 代码 其 实 并 没有 太 多 可 以 摘 述 的 ， 
为 通过 SAX 解 析 XML 文 档 的 套路 大 致 都 差不多 ， 
Spring 在 这 里 并 没有 什么 特殊 的 地 方 ， 同 样 首 先 创 
建 DocumentBuilderFactory， 再 通过 
DocumentBuilderFactory 创 建 DocumentBuilder， 进 
而 解析 inputSource 来 返回 Document 对 象 。 对 此 感 兴 
趣 的 读者 可 以 在 网 上 获取 更 多 的 资料 。 这 里 有 必要 
提 及 一 ， 对 于 参数 
传 入 的 是 通过 getEntityResolverO 函 数 获 取 的 返 
值 ， 如 下 代码 : 














protected EntityResolver getEntityResolver() { 
if (this.entityResolver == null) { 
// Determine default EntityResolver to use. 
ResourceLoader resourceLoader = getResourceLoader ( 


); 
if (resourceLoader !- null) { 
this.entityResolver = new ResourceEntityResolv 


er(resourceLoader); 
else ( 


this.entityResolver-new DelegatingEntityResolv 
er (getBeanClassLoader()); 


return this.entityResolver; 


| O O 
那么 ，EntityResolver 到 底 是 做 什么 用 的 呢 ? 


2.7.1 EntityResolver 用 法 


在 loadDocument 方 法 中 涉及 一 个 参数 
EntityResolver， 何 为 EntityResolver? 官网 这 样 解释 : 
如 果 SAX 应 用 程序 需要 实现 自 定义 处 理 外 部 实体 ， 
则 必须 实现 此 接口 并 使 用 setEntityResolver 方 法 问 
SAX 驱动 器 注册 一 个 实例 。 也 就 是 说 ， 对 于 解析 一 
个 XML，SAX 首 先 读 取 该 XML 文 档 上 的 声明 ， 根 
据 声 明 去 寻找 相应 的 DTD 定 义 ， 以 便 对 文档 进行 一 
个 验证 。 默 认 的 寻找 规则 ， 即 通过 网 络 〈( 实 现 上 整 
是 声明 的 DID 的 URI 地 址 ) 来 下 载 相应 的 DTD 声 
明 ， 并 进行 认证 。 下 载 的 过 程 是 一 个 漫长 的 过 程 ， 
而 且 当 网 络 中 断 或 不 可 用 时 ， 这 里 会 报错 ， 束 是 因 
为 相应 的 DID 声明 没有 被 找到 的 原因 。 


EntityResolver 的 作用 是 项 目 本 吴 误 可 以 提供 一 
个 如 何 寻 找 DTD 声 明 的 方法 ， 即 由 程序 来 实现 寻找 
DTD 声 明 的 过 程 ， 比 如 我 们 将 DTD 文 件 放 到 项 目 中 
东 处 ， 在 实现 时 直接 将 此 文档 读 取 并 返回 给 SAX 即 
可 。 这 样 焉 避免 了 通过 网 络 来 寻找 相应 的 声明 。 


首先 看 entityResolver 的 接口 方法 声明 : 




















InputSource resolveEntity(String publicId, String systemId) 


这 里 ， 它 接收 两 个 参数 publicId 和 systemId， 并 
返回 一 个 inputSource 对 象 。 这 里 我 们 以 特定 配置 文 
件 来 进行 讲解 。 


1. 如 果 我 们 在 解析 验证 模式 为 XSD 的 配置 文 
件 ， 代 码 如 下 : 


«?xml version="1.0" encoding="UTF-8"?> 
<beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" 


xsi:schemaLocation="http://www.Springframework.org/schema/ 
beans 


http://www.springframework.org/schema/beans/Spring-beans. 


xsd 


Ws 


</beans> 





读 取 到 以 下 两 个 参数 。 


e publicId: null 
e systemld: 


http://www.springframework.org/schema/beans/Spr. 
beans.xsd 


2. 如 果 我 们 在 解析 验证 模式 为 DTD 的 配置 文 


件 ， 代 码 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE beans PUBLIC "-//Spring//DTD BEAN 2.0//EN" "http://ww 
w.Springframework. org/dtd/Spring-beans-2.0.dtd"> 


</beans> 





读 取 到 以 下 两 个 参数 。 


e publicId: -//Spring//DTD BEAN 2.0//EN 

e systemld: 
http://www.springframework.org/dtd/Spring-beans- 
2.0.dtd 


之 前 已 经 提 到 过 ， 验 证 文件 默认 的 加 载 方式 是 
通过 URL 进 行 网 络 下 载 获取 ， 这 样 会 造成 延迟 ， 用 
户 体验 也 不 好 ， 一 般 的 做 法 都 是 将 验证 文件 放置 在 
目 己 的 工程 里 ， 那 么 怎么 做 才能 将 这 个 URL 转 换 为 
目 己 工程 里 对 应 的 地 址 文件 呢 ? 我 们 以 加 载 DTD 文 
件 为 例 来 看 看 Spring 中 是 如 何 实现 的 。 根 据 之 前 
Spring 中 通过 getEntityResolver(O) 方 法 对 
EntityResolver 的 获取 ， 我 们 知道 ，Spring 中 使 用 
DelegatingEntityResolver 类 为 EntityResolver 的 实现 
类 ，resolveEntity 实 现 方 法 如 下 : 











DelegatingEntityResolver.java 





public InputSource resolveEntity(String publicId, String s 
ystemId) throws 
SAXException, IOException { 
if (systemId != null) { 
if (systemId.endswith(DTD_SUFFIX)) { 
// 如 果 是 dtd 从 这 里 解析 
return this.dtdResolver.resolveEntity(publicId 





, SystemId); 


} 
else if (systemId.endsWith(XSD SUFFIX)) { 
// 通 过 调用 META-INF/Spring.schemas 解 析 
return this.schemaResolver.resolveEntity(publi 
cId, systemId); 





return null; 





我 们 可 以 看 到 ， 对 不 同 的 验证 模式 ，Spring 使 
用 了 不 同 的 解析 器 解析 。 这 里 简单 描述 一 下 原理 ， 
比如 加 载 DTD 关 型 的 BeansDtdResolver 的 
resolveEntity 是 直接 截取 systemId 最 后 的 xx.dtd 然 后 
去 当前 路 径 下 寻找 ， 而 加 载 XSD 类型 的 
PluggableSchemaResolver 类 的 resolveEntity 是 默认 到 
META-INF/Spring.schemas 文 件 中 找到 systemid 所 对 
应 的 XSD 文件 并 加 载 。 





BeansDtdResolver.java 





public InputSource resolveEntity(String publiclId, String system 
Id)throws IOException ( 
if (logger.isTraceEnabled()) { 
logger.trace("Trying to resolve XML entity with pu 
blic ID [" + publicId + 
"] and system ID [" + systemId + "]"); 


j 


// DTD EXTENSION - ".dtd"; 
if (SystemId != null && systemId.endsWith(DTD EXTENSIO 


N)) ( 
int lastPathSeparator - systemId.lastIndexOf("/"); 
for (String DTD NAME : DTD NAMES) { 
// DTD NAMES = {"Spring-beans-2.0", "Spring-be 
ans"); 
int dtdNameStart = systemId.indexOf(DTD NAME); 
if (dtdNameStart » lastPathSeparator) ( 
String dtdFile - systemId.substring(dtdNam 
eStart); 


if (logger.isTraceEnabled()) { 
logger.trace("Trying to locate [" + dt 
dFile +"]in Spring jar"); 


try { 
Resource resource - new ClassPathResou 


rce(dtdFile, getClass()); 
InputSource source - new InputSource(r 
esource.getInputStream()); 
source.setPublicId(publicId); 
source.setSystemId(systemId); 
if (logger.isDebugEnabled()) { 
logger.debug("Found beans DTD [" + 
systemId + "] in 
classpath: " + dtdFile); 


return source; 


catch (IOException ex) { 
if (logger.isDebugEnabled()) { 
logger .debug( "Could not resolve be 
ans DTD [" + systemId + "]: not found in class path", ex); 


j 
j 


j 


j 


return null; 





2.8 ”解析 及 注册 BeanDefinitions 





当 把 文件 转换 为 Document 后 ， 接 下 来 的 提取 及 
注册 bean 束 是 我 们 的 重头 戏 。 继 续 上 面 的 分 析 ， 妆 
程序 已 经 拥有 XML 文档 文件 的 Document 实 例 对 象 
时 ， 束 会 被 引入 下 面 这 个 方法 。 


XmlBeanDefinitionReader.java 


public int registerBeanDefinitions(Document doc, Resource resou 
rce) throws BeanDefinitionStore Exception { 

// 使 用 DefaultBeanDefinitionDocumentReader 实 例 化 BeanDefin 
itionDocumentReader 

BeanDefinitionDocumentReader documentReader=createBean 
DefinitionDocumentReader(); 

// 将 环境 变量 设置 其 中 

documentReader.setEnvironment(this.getEnvironment()); 

// 在 实例 化 BeanDefinitionReader 时 候 会 将 BeanDefinitionRegis 
try 传 入 ， 默 认 使 用 继承 白 DefaultListableBeanFactory 的 子 类 

// 记 录 统 计 前 BeanDefinition 的 加 载 个 数 

int countBefore = getRegistry().getBeanDefinitionCount 








// 加 载 及 注册 bean 
documentReader .registerBeanDefinitions 


(doc, createReaderContext(resource)); 

// 记 录 本 次 加 载 的 BeanDefinition 个 数 

return getRegistry().getBeanDefinitionCount() - countB 
efore; 


j 





其 中 的 参数 doc 是 通过 上 一 节 ]oadDocument 加 
载 转换 出 来 的 。 在 这 个 方法 中 很 好 地 应 用 了 面 同 对 
象 中 单一 职 贡 的 原则 ， 将 逻辑 人 处理 委托 给 单一 的 类 





进行 处 理 ， 而 这 个 逻辑 处 理 类 就 是 
BeanDefinitionDocumentReader. 
BeanDefinitionDocumentReader 是 一 个 接口 ， 而 实例 
化 的 工作 是 在 createBeanDefinitionDocumentReader() 
中 完成 的 ， 而 通过 此 方法 ， 
BeanDefinitionDocumentReader 真 正 的 类 型 其 实 已 经 
是 DefaultBeanDefinitionDocumentReader 了 ， 进 入 
DefaultBeanDefinitionDocument- Reader 后 ， 发 现 这 
个 方法 的 重要 目的 之 一 束 是 提取 root， 以 便于 再 次 
将 root 作 为 参数 继续 BeanDefinition 的 注册 。 








public void registerBeanDefinitions(Document doc, XmlReaderCont 
ext readerContext)( 
this.readerContext - readerContext; 


logger.debug("Loading bean definitions"); 
Element root = doc.getDocumentElement(); 


doRegisterBeanDefinitions 


(root); 
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逻辑 的 底部 doRegisterBeanDefinitions(roob， 至 少 我 
们 在 这 个 方法 中 看 到 了 希望 。 


如 果 说 以 前 一 直 是 XML 加 载 解 析 的 准备 阶段 ， 
那么 doRegisterBeanDefinitions 算 是 真正 地 开始 进行 
解 机 了， 我 们 期 竺 的 核心 部 分 真正 开始 了 。 





protected void doRegisterBeanDefinitions(Element root) { 
// 处 理 profile 属 性 
String profileSpec = root.getAttribute(PROFILE ATTRIBUTE 




















); 
if (StringUtils.hasText(profileSpec)) { 

Assert.state(this.environment !-null, "environment pro 
perty must not be null"); 

String[] specifiedProfiles - StringUtils.tokenizeToStr 
ingArray(profileSpec, 
BeanDefinitionParserDelegate.MULTI VALUE ATTRIBUTE DELIMITERS); 

if (!this.environment.acceptsProfiles(specifiedProfile 
s)) { 


return; 


} 














B 

// 专 门 处 理解 析 

BeanDefinitionParserDelegate parent = this.delegate; 
this.delegate - createHelper(readerContext, root, parent); 























// 解 析 前 处 理 ， 留 给 子 类 实现 
preProcessXml(root); 
parseBeanDefinitions 

















(root, this.delegate); 
// 解 析 后 处 理 ， 留 给 子 类 实现 
postProcessXml(root); 
































this.delegate - parent; 





XR Er RS PE SU f AERE B7 
对 profile 的 处 理 ， 然 后 开始 进行 解析 ， 可 是 当 我 们 
FRE preProcess Xml(root) && 2t postProcessXml(root) / 
MABET, BREWS IRA TTA ANE? s 
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么 是 面 同 继 承 的 设计 的 ， 要 么 就 用 final 修 饰 。 在 
DefaultBeanDefinitionDocumentReader 中 并 没有 用 








final 修 饰 ， 所 以 它 是 面 回 继承 而 设计 的 。 这 两 个 方 
法 正 是 为 子 类 而 设计 的 ， 如 果 读 者 有 了 解 过 设计 模 
式 ， 可 以 很 快速 地 反映 出 这 是 模版 方法 模式 ， 如 果 
继承 目 DefaultBeanDefinitionDocumentReader 的 子 类 
需要 在 Bean 解 析 前 后 做 一 些 处 理 的 话 ， 那 么 只 需要 
重 写 这 两 个 方法 束 可 以 了 。 


2.8.1 ”profile 属 性 的 使 用 


我 们 注意 到 在 注册 Bean 的 最 开始 是 对 
PROFILE_ATTRIBUTE 属 性 的 解析 ， 可 能 对 于 我 们 
来 说 ，profile 属 性 并 不 是 很 党 用。 让 我 们 先 了 解 一 
下 这 个 属性 。 





分 析 profile 前 我 们 先 了 解 下 profile 的 用 法 ， 官 
方 示例 代码 片段 如 下 : 





«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.0rg/2001/XMLSchema-instance" xmlns 

:jdbcz"http://www. Springframework.org/schema/jdbc" 
xmlns:jee="http://www.springframework.org/schema/jee" 
xsi:schemaLocationz"..."» 


> 
</beans> 
<beans profile="production" 


«/beans» 
«/beans» 


集成 到 Web 环 境 中 时 ， 在 web.xml 中 加 入 以 下 
代码 : 
<context- param> 


<param-name>Spring.profiles.active</param-name> 
<param-value>dev 


</param-value> 
</context-param> 
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更 换 不 同 的 数据 库 。 


了 解 了 profile 的 使 用 再 来 分 析 代 码 会 清晰 得 
多 ， 首 先 程序 会 获取 beans 节 点 是 否定 义 了 profile 属 
性 ， 如 果 定 义 了 则 会 需要 到 环境 变量 中 去 寻找 ， 所 
以 这 里 首先 断言 environment 不 可 能 为 空 ， 因 为 
profile 是 可 以 同时 指定 多 个 的 ， 需 要 程序 对 其 拆 
分 ， 并 解析 每 个 profile 是 都 符合 环境 变量 中 所 定义 
HY, ANE SOU AN SSR BEE EE AAT o 























2.8.2 ”解析 并 注册 BeanDefinition 


Ab f profiles wt n] EAXETTXML BERE. SR 
Ee RSE A parseBeanDefinitions(root, 
this.delegate). 


protected void parseBeanDefinitions(Element root, BeanDefinitio 
nParserDelegate delegate) { 
// 对 beans 的 处 理 
if (delegate.isDefaultNamespace(root)) { 
NodeList nl = root.getChildNodes(); 
for (int i = 0; i < nl.getLength(); i++) { 
Node node = nl.item(i); 
if (node instanceof Element) { 
Element ele = (Element) node; 
if (delegate.isDefaultNamespace(ele)) { 
//Xt bean Hy 4b 3 
parseDefaultElement(ele, delegate); 






































j 


else ( 
// 对 bean 的 处 理 
delegate.parseCustomElement(ele); 




















} 
} 


else ( 
delegate.parseCustomElement(root); 


j 








上 面 的 代码 看 起 来 逻辑 还 是 弯 清 晰 的 ， 因 为 在 
Spring 的 XML 配置 里 面 有 两 大 类 Bean 声 明 ， 一 个 是 
默认 的 ， 如 : 


«bean id-"test" class="test.TestBean"/> 











为 一 类 束 是 目 定义 的 ， 如 : 


<tx:annotation-driven/> 


而 两 种 方式 的 读 取 及 解析 差别 是 非常 大 的 ， 如 
果 采 用 Spring 默认 的 配置 ，Spring 当 然 知 道 该 怎么 
做 ， 但 是 如 果 是 目 定 义 的 ， 那 么 束 需 要 用 户 实现 一 
些 接口 及 配置 了 。 对 于 根 市 点 或 者 子 节 点 如 果 是 默 
认命 名 空间 的 话 则 采用 parseDefaultElement 方 法 进 
行 解 析 ， BU FHdelegate.parseCustomElement7; 7X 
i 目 定 义 命名 空间 进行 解析 。 而 判断 是 否 默 认命 名 
空间 还 是 上 日 定义 命名 空间 的 办 法 其 实 是 使 用 

node. getNamespaceURIQ 5X Ctr 名 空间 ， 并 与 Spring 
中 国定 的 命名 空间 
http://www.springframework.org/schema/beans 进 行 比 
对 。 如 果 一 致 则 认为 是 默认 ， 否 则 束 认 为 古 自 定 
义 。 而 对 于 默认 标签 解析 与 目 定义 标签 解 术 我们 将 
会 在 下 一 章 中 进行 讨论 。 


























第 3 草 ”默认 标签 的 解析 


之 前 所 到 过 Spring 中 的 标签 包括 默认 标签 自 
定义 标签 两 种 ， 而 两 种 标签 的 用 法 以 及 解析 方式 存 
在 着 很 大 的 不 同 ， 本 半 市 各 点 带领 读者 评 细 分 析 默 
认 标签 的 解析 过 程 。 


默认 标签 的 解析 是 在 parseDefaultElement 函 数 
中 进行 的 ， 函 数 中 的 功能 逻辑 一 目 了 然 ， 分 别 对 4 
种 不 同 标签 (import、aliass、bean 和 beans) 做 了 不 
同 的 处 理 。 








private void parseDefaultElement(Element ele, BeanDefinitio 
nParserDelegate delegate) { 

















// 对 import 标 签 的 处 理 
if (delegate.nodeNameEquals(ele, IMPORT ELEMENT)) { 
importBeanDefinitionResource 


(ele); 














// 对 alias 标 签 的 处 理 
else if (delegate.nodeNameEquals(ele, ALIAS ELEMENT)) 








processAliasRegistration 


(ele); 











// 对 bean 标 签 的 处 理 
else if (delegate.nodeNameEquals(ele, BEAN ELEMENT)) { 
processBeanDefinition 








(ele, delegate); 














// 对 beans 标 签 的 处 理 
else if (delegate.nodeNameEquals(ele, NESTED BEANS ELE 
MENT)) ( 








doRegisterBeanDefinitions 
(ele); 


j 





3.1 bean 标签 的 解析 及 注册 


在 4 种 标签 的 解析 中 ， 对 bean 标 签 的 解析 最 为 
复杂 也 最 为 重要 ， 所 以 我 们 从 此 标签 开始 深入 分 
析 ， 如 果 能 理解 此 标签 的 解析 过 程 ， 其 他 标签 的 解 
析 自 然 会 迎刃而解 。 首 先 我 们 进入 函 数 


processBeanDefinition(ele, delegate). 





protected void processBeanDefinition(Element ele, BeanDefinitio 
nParserDelegate delegate) { 

BeanDefinitionHolder bdHolder - delegate.parseBeanDefi 
nitionElement 


(ele); 
if (bdHolder !- null) ( 
bdHolder = delegate.decorateBeanDefinitionlIfRequir 
ed 


(ele, bdHolder); 


try { 
BeanDefinitionReaderUtils.registerBeanDefiniti 
on 


(bdHolder, getReaderContext(). getRegistry()); 


catch (BeanDefinitionStoreException ex) ( 
getReaderContext().error("Failed to register b 
ean definition with name '" + 


bdHolder.getBeanName() + "'", ele, ex) 


getReaderContext().fireComponentRegistered 
(new BeanComponentDefinition(bdHolder)); 


j 








/E—É&. MPA, BOA VA BUTS] BRA 
TUG dE. ABU S S EET. 


1. 首先 委托 BeanDefinitionDelegate 类 的 
parseBeanDefinitionElement 方 法 进行 元 素 解 析 ， 
器 BeanDefinitionHolder 类 型 的 实例 bdHolder， ^s 
这 个 方法 后 ，bdHolder 实 例 已 经 包含 我 们 配置 文件 
中 配置 的 各 种 属性 了 ， 例 如 class、name、id、alias 
之 类 的 属性 。 


2. 当 返 回 的 pbpdHolder 不 为 空 的 情况 下 大 存在 
默认 标签 的 子 节点 下 再 有 目 定义 属性 ， 还 需要 再 次 
对 目 定 义 标签 进行 解析 。 


3. 解析 完成 后 ， 需 要 对 解析 后 的 bdHolder 进 
行 注 册 ， 同 样 ， 注 册 操 作 委 托 给 了 Bean- 
DefinitionReaderUtilsHJregisterBeanDefinition 7 7X . 














4， 最 后 发 出 啊 应 事件 ， 通 知 相 关 的 监听 器 ， 
这 个 bean 已 经 加 载 完 成 了 。 


配合 时 序 图 〈 见 图 3-1) ， 可 能 会 更 容易 理 
解 。 





1: decorateBeanDefinitionlfRequired(ele bdHolder) 





图 3-1 bean 标签 的 解析 及 注册 时 序 图 
3.1.1 解析 BeanDefinition 


下 面 我 们 束 针 对 各 个 操作 做 具体 分 析 。 前 先 我 
们 从 元 素 解 析 及 信息 提取 开始 ， 也 束 古 
BeanDefinitionHolder bdHolder = 
delegate.parseBeanDefinitionElement(ele), iA 
BeanDefinition- Delegate 类 的 


parseBeanDefinitionElement77 1X; . 


BeanDefinitionDelegate.java 





public BeanDefinitionHolder parseBeanDefinitionElement(Element 
ele) { 


return parseBeanDefinitionElement 


(ele, null); 
} 


public BeanDefinitionHolder parseBeanDefinitionElement(Element 
ele, BeanDefinition 
containingBean) { 
// 解 析 id 属 性 
String id = ele.getAttribute(ID ATTRIBUTE 








); 
// 解 析 name 属 性 
String nameAttr = ele.getAttribute(NAME ATTRIBUTE 








); 


// 分 割 name 属 性 
List<String> aliases = new ArrayList«cString»(); 
if (StringUtils.hasLength(nameAttr)) { 
String[] nameArr = StringUtils.tokenizeToStringArr 
ay(nameAttr, MULTI_ 
VALUE ATTRIBUTE DELIMITERS); 
aliases.addAll(Arrays.asList(nameArr)); 





j 


String beanName - id; 
if (!StringUtils.hasText(beanName) && !aliases.isEmpty 
O) t 
beanName - aliases.remove(0); 
if (logger.isDebugEnabled()) { 
logger.debug("No XML 'id' specified - using '" 
+ beanName + 
"' as bean name and " + aliases + " as 
aliases"); 


j 


if (containingBean -- null) ( 
checkNameUniqueness(beanName, aliases, ele); 


j 


AbstractBeanDefinition beanDefinition - parseBeanDefin 
itionElement 


(ele, beanName, containingBean); 


if (beanDefinition !- null) ( 
if (!StringUtils.hasText(beanName)) { 
try { 














// 如 果 不 存在 beanName 那 么 根据 Spring 中 提供 的 命名 规 
则 为 当前 bean 生 成 对 应 的 
//beanName 
if (containingBean != null) { 
beanName = BeanDefinitionReaderUtils.g 
enerateBeanName ( 
beanDefinition, this.readerCon 
text.getRegistry(), true); 


else ( 
beanName - this.readerContext.generate 
BeanName (beanDefinition); 


String beanClassName - beanDefinition. 
getBeanClassName(); 
if (beanClassName !- null && 
beanName.startsWith(beanClassN 
ame) && beanName.length() » beanClassName.length() && 
Ithis.readerContext.getRegistr 
y(). IsBeanNameInUse 
(beanClassName)) { 
aliases.add(beanClassName); 


j 


} 
if (logger.isDebugEnabled()) { 
logger.debug("Neither XML 'id' nor 'na 
me' specified - " + 
"using generated bean name [" 
+ beanName + "]"); 


j 


catch (Exception ex) { 
error(ex.getMessage(), ele); 


return null; 


j 


} 

String[] aliasesArray = StringUtils.toStringArray( 
aliases); 

return new BeanDefinitionHolder(beanDefinition, be 
anName, aliasesArray); 


return null; 


j 





以 上 便 是 对 默认 标签 解析 的 全 过 程 了 。 当 然 ， 





对 Spring 的 解析 犹如 洋 葡 剥皮 一 样 ， 一 层 一 层 地 进 
行 ， 尽 管 现在 只 能 看 到 对 属性 id 以 及 name 的 解析 ， 
但 是 很 庆幸 ， 思 路 我 们 已 经 了 解 了 。 在 开始 对 属性 
展开 全 面 解析 前 ，Spring 在 外 层 又 做 了 一 个 当前 层 
HI BEAR TY 在 当前 层 完 成 的 主要 工作 包括 如 下 内 
人 














1. 提取 元 素 中 的 id 以 及 name 属 性 。 
2. 进一步 解析 其 他 所 有 属性 并 统一 封 沪 至 


GenericBeanDefinition 类 型 的 实例 中 。 


3. 如 果 检 测 到 bean 没 有 指定 beanName， 那 么 
使 用 默认 规则 为 此 Bean 生 成 beanName。 


4. 将 获取 到 的 信息 封装 到 
BeanDefinitionHolder 的 实例 中 。 


我 们 进一步 地 碍 看 步骤 2 中 对 标签 其 他 属性 的 
解析 过 程 。 





public AbstractBeanDefinition parseBeanDefinitionElement( 
Element ele, String beanName, BeanDefinition conta 
iningBean) ( 


this.parseState.push(new BeanEntry(beanName)); 


String className - null; 
// 解 析 class 属 性 
if (ele.hasAttribute(CLASS ATTRIBUTE)) ( 

className - ele.getAttribute(CLASS ATTRIBUTE).trim 


—= 








j 


try { 
String parent - null; 


// 解 析 parent 属 性 
if (ele.hasAttribute(PARENT ATTRIBUTE)) { 
parent = ele.getAttribute(PARENT ATTRIBUTE); 











} 

// 创 建 用 于 承载 属性 的 AbstractBeanDefinition 类 型 的 Generi 
cBeanDefinition 

AbstractBeanDefinition bd = createBeanDefinition 





(className, parent); 





// 便 编码 解析 默认 bean 的 各 种 属性 


parseBeanDefinitionAttributes 


—= 








(ele, beanName, containingBean, bd); 
/ /TéRt description 
bd.setDescription(DomUtils.getChildElementValueByT 
agName(ele, DESCRIPTION  ELEMENT)); 


// 解 析 元 数据 


parseMetaElements 





(ele, bd); 








// 解 析 Llookup -method 属 性 
parseLookupOverrideSubElements 


—= 


(ele, bd.getMethodOverrides()); 
//fe it replaced -method)s’ 
parseReplacedMethodSubElements 


HE 








(ele, bd.getMethodOverrides()); 


// 解 析 构 造 函 数 参数 


parseConstructorArgElements 

















(ele, bd); 
// 解 析 property 子 元 素 
parsePropertyElements 
(ele, bd); 
// 解 析 qualifier 子 元 素 
parseQualifierElements 
(ele, bd); 


bd.setResource(this.readerContext.getResource()); 
bd.setSource(extractSource(ele) ); 


return bd; 


catch (ClassNotFoundException ex) { 
error("Bean class [" + className + "] not found", 
ele, ex); 
} 
catch (NoClassDefFoundError err) { 
error("Class that bean class [" +className +"] dep 
ends on not found", ele, err); 


} 
catch (Throwable ex) { 
error("Unexpected failure during bean definition p 
arsing", ele, ex); 


finally { 
this.parseState.pop(); 


j 


return null; 





终于 ，bean 标 签 的 所 有 属性 ， 不 论 弟 用 的 还 是 
不 第 用 的 我 们 部 看 到 了 ， 尺 官 有 些 复杂 的 属性 还 需 
要 进一步 的 解析 ， 不 过 丝毫 不 会 影响 我 们 兴奋 的 心 
情 。 接 下 来 ， 我 们 继续 一 些 复杂 标签 属性 的 解析 。 








1. 创建 用 于 属性 承载 的 BeanDefinition 


BeanDefinition 是 一 个 接口 ， 在 Spring 中 存在 三 
种 实现 : RootBeanDefinition、ChildBean- Definition 
以 及 GenericBeanDefinition。 三 种 实现 均 继 承 了 
AbstractBeanDefiniton， 其 中 BeanDefinition 是 配置 
文件 <bean> 元 素 标签 在 容器 中 的 内 部 表示 形式 。 
<bean> 元 素 标 签 拥 有 class、scope、l]azy-init 等 配置 
属性 ，BeanDefinition 则 提供 了 相应 的 beanClass、 
scope、lazyInit 属 性 ，BeanDefinition 和 <bean> 中 的 
属性 是 一 一 对 应 的 。 其 中 RootBeanDefinition 是 最 常 
用 的 实现 类 ， 它 对 应 一 般 性 的 <bean> 元 素 标签 ， 
GenericBeanDefinition 是 和 目 2.5 版 本 以 后 新 加 入 的 
bean 文 件 配置 属性 定义 类 ， 是 一 站 式 服 务 类 。 


在 配置 文件 中 可 以 定义 父 <bean> 和 子 <bean>， 
人 <bean> 用 RootBeanDefinition 表 示 ， 而 子 <bean> 用 
ChildBeanDefiniton 表 示 ， 而 没有 父 <bean> 的 <bean> 
就 使 用 RootBeanDefinition 表 示 。 
AbstractBeanDefinition 对 两 者 共同 的 类 信息 进行 抽 


o 





Spring 通过 BeanDefinition 将 配置 文件 中 的 
<bean> 配 置信 息 转 换 为 容器 的 内 部 表示 ， 并 将 这 些 
BeanDefiniton 注 册 到 BeanDefinitonRegistry 中 。 
Spring %¥ 2s 1) BeanDefinitionRegistry 3l 4 4e Spring Ac 
置信 息 的 内 存 数 据 库 ， 主 要 是 以 map 的 形式 保存 ， 
后 续 操 作 直 接 从 BeanDefinition- Registry 中 读 取 配置 
信息 。 它 们 之 间 的 关系 如 图 3-2 所 示 。 








加 «Java Class» 四 «Java Class» | al «Java Class» 
© RootBeanDefinition © Generic BeanDefinition | © ChildBeanDefinition 
| 
p} x | ir; } 
| | 
Al «Java Class» | 
© AbstractBeanDefinition | 
四 
Al «Java Interface» 


BeanDefinition | 


图 3-2” BeanDefinition 及 其 实现 类 


由 此 可 知 ， 要 解析 属性 首先 要 创建 用 于 承载 属 
性 的 实例 ， 也 就 是 创建 GenericBeanDefinition 类 型 
的 实例 。 而 代码 createBeanDefinition(className,， 
parent) 的 作用 就 是 实现 此 功能 。 





protected AbstractBeanDefinition createBeanDefinition(String cl 
assName, String parentName) 
throws ClassNotFoundException ( 


return BeanDefinitionReaderUtils.createBeanDefinition( 


parentName, className, this.readerContext.getB 
eanClassLoader()); 


j 





BeanDefinitionReaderUtils.java 


public static AbstractBeanDefinition createBeanDefinition( 
String parentName, String className, ClassLoader c 

lassLoader) throws 

ClassNotFoundException { 


GenericBeanDefinition bd - new GenericBeanDefinition() 


//parentName 可 能 为 空 
bd.setParentName(parentName); 
if (className !- null) ( 
if (classLoader !- null) ( 
// 如 果 classLoader 不 为 空 ， 则 使 用 以 传 入 的 classLoader 同 一 虚 


拟 机 加 载 类 对 象 ， 否 则 只 是 
// 记 录 className 
bd.setBeanClass(ClassUtils.forName(className, 


classLoader)); 
} 
else { 
bd.setBeanClassName(className); 
} 
} 


return bd; 





2. 解析 各 种 属性 
当 我 们 创建 了 bean 信 息 的 承载 实例 后 ， 便 可 以 


进行 bean 信 息 的 各 种 属性 解析 了 ， 首 移 我 们 进入 
parseBeanDefinitionAttributes 方 法 。 
parseBeanDefinitionAttributes 方 法 是 对 element 所 有 
元 素 属性 进行 解析 : 





public AbstractBeanDefinition parseBeanDefinitionAttributes(Ele 
ment ele, String beanName, 
BeanDefinition containingBean, AbstractBeanDefinit 


ion bd) ( 


/ / fitr scope jE VE 
if (ele.hasAttribute(SCOPE ATTRIBUTE)) ( 
// Spring 2.x "scope" attribute 
bd.setScope(ele.getAttribute(SCOPE ATTRIBUTE)); 
if (ele.hasAttribute(SINGLETON ATTRIBUTE)) ( 
//scope 与 Singleton 两 个 属性 只 能 指定 其 中 之 一 ， 不 可 以 同时 出 现 ， 否 
则 Spring 将 会 报 出 异常 
error("Specify either 'scope' or 'singleton', 
not both", ele); 


—= 














} 
// 解 析 singleton 属 性 
else if (ele.hasAttribute(SINGLETON ATTRIBUTE)) { 
// Spring 1.x "singleton" attribute 
bd.setScope(TRUE_VALUE.equals(ele.getAttribute(SIN 
GLETON_ATTRIBUTE)) ? 
BeanDefinition.SCOPE_SINGLETON : BeanDefin 
ition.SCOPE_PROTOTYPE) ; 


—= 





else if (containingBean != null) { 

// Take default from containing bean in case of an inn 
er bean definition. 

/V/ 在 嵌入 beanDifinition 情 况 下 且 没 有 单独 指定 scope 属 性 则 使 用 父 类 
默认 的 属性 




















bd.setScope(containingBean.getScope()); 


} 
// 解 析 abstract 属 性 
if (ele.hasAttribute(ABSTRACT_ATTRIBUTE)) ( 
bd.setAbstract(TRUE VALUE.equals(ele.getAttribute( 
ABSTRACT. ATTRIBUTE))); 


—= 








// 解 析 lazy-init 属 性 
String lazyInit = ele.getAttribute(LAZY INIT ATTRIBUTE 








); 
if (DEFAULT VALUE.equals(lazyInit)) ( 
lazyInit - this.defaults.getLazyInit(); 
} 
// 若 没有 设置 或 设置 成 其 他 字符 都 会 被 设置 为 false 
bd.setLazyInit(TRUE VALUE.equals(lazyInit)); 








// 解 析 autowire 属 性 
String autowire = ele.getAttribute(AUTOWIRE ATTRIBUTE) 








bd.setAutowireMode(getAutowireMode(autowire)); 


// 解 析 dependency-check 属 性 

String dependencyCheck = ele.getAttribute(DEPENDENCY_C 
HECK ATTRIBUTE); 

bd. setDependencyCheck(getDependencyCheck(dependencyChe 














ck)); 
//fe Ht depends -on 属性 
if (ele.hasAttribute(DEPENDS_ON_ATTRIBUTE)) { 
String dependsOn = ele.getAttribute(DEPENDS ON ATT 
RIBUTE); 


bd.setDependsOn(StringUtils.tokenizeToStringArray( 
dependsOn, MULTI VALUE JATTRIBUTE DELIMITERS)); 


j 


// 解 机 autowire-candidate 属 性 
String autowireCandidate = ele.getAttribute(AUTOWIRE C 
ANDIDATE ATTRIBUTE); 
if ("".equals(autowireCandidate) || DEFAULT VALUE.equa 
ls(autowireCandidate)) { 
String candidatePattern - this.defaults.getAutowir 
eCandidates(); 
if (candidatePattern ! 
String[] patterns 
ListToStringArray 
(candidatePattern); 
bd.setAutowireCandidate(PatternMatchUtils.simp 
leMatch(patterns, beanName)); 








null) ( 
StringUtils.commaDelimited 


j 


else ( 
bd.setAutowireCandidate(TRUE VALUE.equals(autowire 


Candidate)); 


—= 


// 解 析 primary 属 性 
if (ele.hasAttribute(PRIMARY_ATTRIBUTE)) { 
bd.setPrimary(TRUE VALUE.equals(ele.getAttribute(P 
RIMARY. ATTRIBUTE))); 








} 
// 解 析 init-method 属 性 
if (ele.hasAttribute(INIT METHOD ATTRIBUTE)) { 
String initMethodName = ele.getAttribute(INIT METH 
OD ATTRIBUTE); 
if (!"".equals(initMethodName)) { 
bd.setInitMethodName(initMethodName); 








j 


else ( 
if (this.defaults.getInitMethod() != null) { 
bd.setInitMethodName(this.defaults.getInitMeth 
od()); 
bd.setEnforceInitMethod( false); 
} 


} 
// 解 析 destroy-method 属 性 
if (ele.hasAttribute(DESTROY METHOD ATTRIBUTE)) { 
String destroyMethodName - ele.getAttribute(DESTRO 
Y METHOD ATTRIBUTE); 
if (!"".equals(destroyMethodName)) { 
bd.setDestroyMethodName (destroyMethodName); 


—= 








j 
j 


else ( 
if (this.defaults.getDestroyMethod() !- null) ( 
bd.setDestroyMethodName(this.defaults.getDestr 
oyMethod()); 
bd.setEnforceDestroyMethod(false); 


j 


} 
// 解 析 factory-method 属 性 
if (ele.hasAttribute(FACTORY METHOD ATTRIBUTE)) { 
bd.setFactoryMethodName(ele.getAttribute(FACTORY M 
ETHOD ATTRIBUTE)); 


—= 














} 
// 解 析 factory-bean 属 性 
if (ele.hasAttribute(FACTORY_ BEAN_ATTRIBUTE)) { 


bd.setFactoryBeanName(ele.getAttribute(FACTORY BEA 
N ATTRIBUTE)); 


return bd; 





我 们 可 以 清楚 地 看 到 Spring 完成 了 对 所 有 bean 
属性 的 解析 ， 这 些 属 性 中 有 很 多 是 我 们 经 各 使 用 





的 ， 同 时 我 相信 也 一 定 会 有 或 多 或 少 的 属性 是 读者 
不 熟悉 或 者 是 没有 使 用 过 的 ， 有 兴趣 的 读者 可 以 傅 
阅 相关 资料 进一步 了 解 每 个 属性 。 


3. 解析 子 元 系 meta 


在 开始 解析 元 数据 的 分 析 前 ， 我 们 先 回顾 一 下 
元 数据 meta 属 性 的 使 用 。 


«bean id="myTestBean" class="bean.MyTestBean"> 


<meta key="testStr" value="aaaaaaaa"/> 
</bean> 





这 上 段 代码 并 不 会 体现 在 MyTestBean 的 属性 当 
中 ， 而 是 一 个 额外 的 声明 ， 当 需要 使 用 里 面 的 信息 
的 时 候 可 以 通过 BeanDefinition 的 getAttribute(key) 方 
法 进行 获取 。 


对 meta 属 性 的 解析 代码 如 下 : 


public void parseMetaElements(Element ele, BeanMetadataAtt 
ributeAccessor 
attributeAccessor) ( 
// 获 取 当 前 节点 的 所 有 子 元 素 
NodeList nl = ele.getChildNodes(); 
for (int i = 0; i < nl.getLength(); i++) { 
Node node = nl.item(i); 
// 提 取 meta 
if (isCandidateElement(node) && nodeNameEquals(nod 
e, META ELEMENT) ) { 
Element metaElement - (Element) node; 
String key - metaElement.getAttribute(KEY ATTR 











IBUTE); 
String value - metaElement.getAttribute(VALUE 
ATTRIBUTE); 


//fiiFlkey. valuefjikBeanMetadataAttribute 

BeanMetadataAttribute attribute - new BeanMeta 
dataAttribute(key, value); 

attribute.setSource(extractSource(metaElement ) 


// 记 录 信 息 
attributeAccessor.addMetadataAttribute(attribu 





4. 解析 子 元 系 lookup-method 


同样 ， 子 元 素 lookup-method 似 乎 并 不 是 很 常 
用 ， 但 是 在 某 些 时 候 它 的 确 是 非常 有 用 的 属性 ， 通 
第 我 们 称 它 为 获取 器 注入 。 引 用 Spring in Action 中 
的 一 句 话 : 获取 器 注入 是 一 种 特殊 的 方法 注入 ， 它 
是 把 一 个 方法 声明 为 返回 某 种 类 型 的 bean， 但 实际 
要 返回 的 bean 是 在 配置 文件 里 面 配置 的 ， 此 方法 可 
用 在 设计 有 些 可 插 拔 的 功能 上 ， 解 除 程序 依赖 。 我 











们 看 看 具体 的 应 用 。 
1. 首先 我 们 创建 一 个 父 关 。 





package test.lookup.bean; 


public class User { 


public void showMe(){ 
System.out.println("i am user"); 
j 





2. Ge HT 25Jf 18 sishowMeZ7 1X. 


package test.lookup.bean; 


public class Teacher extends User( 
public void showMe(){ 
System.out.println("i am Teacher"); 


j 





3. 创建 调用 方法 。 


public abstract class GetBeanTest { 


public void showMe(){ 
this.getBean().showMe(); 


public abstract User getBean(); 





4. 创建 测试 方法 。 


package test.lookup; 


import org.Springframework.context.ApplicationContext; 

import org.Springframework.context.support.ClassPathXmlApplicat 
ionContext; 

import test.lookup.app.GetBeanTest; 


public class Main { 
public static void main(String[] args) { 


ApplicationContext bf - 
new ClassPathXmlApplicationContext("test/looku 
p/lookupTest.xml"); 
GetBeanTest test-(GetBeanTest) bf.getBean("getBeanTest 
1)! 


test.showMe(); 





到 现在 为 止 ， 除了 配置 文件 外 ， 整 个 测试 方法 
束 完 成 了 ， 如 来 之 前 没有 接触 过 获取 右 注 入 的 读者 
们 可 能 会 有 疑问 ， 抽象 方法 还 没有 被 实现 ， 怎 么 可 
以 直接 调用 呢 ? 答案 就 在 Spring 为 我 们 提供 的 获取 
句 中 ， 我 们 看 看 配置 文件 是 怎么 配置 的 。 








<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmilns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xSi:schemaLocation="http://www.springframework.org/schema/ 

beans http://www. 

springframework.org/schema/beans/Spring-beans.xsd"» 


«bean id="getBeanTest" class="test.lookup.app.GetBeanT 
est"> 
«lookup-method name="getBean" bean="teacher"/> 


«/bean» 


«bean id="teacher" class="test.lookup.bean.Teacher"/> 
</beans> 








在 配置 文件 中 ， 我 们 看 到 了 源码 解析 中 提 到 的 
lookup-method 子 元 素 ， 这 个 配置 完成 的 功能 是 动态 
地 将 teacher 所 代表 的 bean 作 为 getBean 的 返回 值 ， 运 
行 测试 方法 我 们 会 看 到 控制 台 上 的 输出 : 


i am Teacher 


当 我 们 的 业务 变更 或 者 在 其 他 情况 下 ，teacher 
里 面 的 业务 馆 辑 已 经 不 再 符合 我 们 的 业务 要 求 ， 需 
MEAT ECE AINE? 这 征 我 们 需要 增加 新 的 过 辑 


类 : 











package test.lookup.bean; 


public class Student extends User { 


public void showMe(){ 
System.out.println("i am student"); 


j 





同时 修改 配置 文件 : 





«?xml version="1.0" encoding="UTF-8"?> 


«beans xmlns="http://www.springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 


xsi:schemaLocation-"http://www.Springframework.org/schema/ 
beans http://www. 


springframework.org/schema/beans/Spring-beans.xsd"» 


«bean id="getBeanTest" class="test.lookup.app.GetBeanT 
est"> 


«lookup-method name="getBean" bean="student"/> 


</bean> 


<bean id="teacher" class="test.lookup.bean.Teacher"/> 
«bean id="student" class="test.lookup.bean.Student"/> 
</beans> 





再 次 运行 测试 类 ， 你 会 及 现 不 一 样 的 结 


i am Student 


至 此 ， 我 们 已 经 初步 了 解 了 lookup-method 子 元 








素 所 提供 的 大 致 功能 ， 相 信 这 时 再 次 去 看 它 的 属性 
提取 源码 会 觉得 更 有 和 针对 性 。 








public void parseLookupOverrideSubElements(Element beanEle 
, MethodOverrides overrides) ( 
NodeList nl = beanEle.getChildNodes(); 
for (int i = 0; i < nl.getLength(); i++) { 
Node node = nl.item(i); 
// 仅 当 在 Spring 默认 bean 的 子 元 素 下 且 为 <lookup-me 








thod 时 有 效 





if (isCandidateElement(node) && nodeNameEquals 
(node, LOOKUP METHOD ELEMENT)) { 
Element ele - (Element) node; 
// 获 取 要 修饰 的 方法 








String methodName = ele.getAttribute(NAME . 
ATTRIBUTE) ; 

// 获 取 配 置 返回 的 bean 

String beanRef = ele.getAttribute(BEAN ELE 
MENT); 

LookupOverride override - new LookupOverri 
de(methodName, beanRef); 

override.setSource(extractSource(ele)); 

overrides.addOverride(override); 





上 面 的 代码 很 眼熟 ， 似 乎 与 parseMetaElements 





的 代码 大 同 小 异 ， 最 大 的 区 别 束 是 在 这 判断 中 的 贡 
点 名 称 在 这 里 被 修改 为 
LOOKUP _ METHOD_ELEMENT。 还 有 ， 在 数据 存 
储 上 面 通 过 使 用 LookupOverride 类 型 的 实体 类 来 进 
行 数 据 承 载 并 记录 在 AbstractBeanDefinition 中 的 
methodOverrides 属 性 中 。 








5. 解析 子 元 素 replaced-method 


这 个 方法 主要 是 对 bean 中 replaced-method 子 元 
系 的 提取 ， 在 开始 提取 分 析 之 前 我 们 还 是 预先 介绍 
下 这 个 元 系 的 用 法 。 


TEAR: 可 以 在 运行 时 用 新 的 方法 蔡 换 现 有 
的 方法 。 与 之 前 的 look-up 不 同 的 是 ，replaced- 
method 不 但 可 以 动态 地 符 换 返回 实体 bean， 而 且 还 

















peo — 
9]. 


1. 在 changeMe 中 完成 某 个 业务 逻辑 。 


public class TestChangeMethod { 


public void changeMe(){ 
System.out.println("changeMe"); 


j 





2. 在 运营 一 段 时 间 后 需要 改变 原 有 的 业务 多 
"E. 


public class TestMethodReplacer implements MethodReplacer { 
@Override 
public Object reimplement(Object obj, Method method, Object[] a 
rgs)throws Throwable { 

System.out.println(" 我 蔡 换 了 原 有 的 方法 " ) ; 

return null; 











3. 使 将 换 后 的 类 生效 。 





<?xml version="1.0" encoding="UTF-8"?> 
«beans xmlns="http://www.Springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instan 


ce" 

xsi:schemaLocation-"http://www.Springframework.org/schema/ 
beans http://www.Springframework. org/schema/beans/Spring-beans 
.xsd"> 


«bean id="testChangeMethod" class="test.replacemethod.Test 
ChangeMethod"> 


«replaced-method name-"changeMe" replacer="replace 
ph 
</bean> 


<bean id="replacer" class="test.replacemethod.TestMethodRe 
placer"/> 


</beans> 





4. 测试 。 


public static void main(String[] args) { 
ApplicationContext bf - 
new ClassPathXmlApplicationContext("test/replacemethod 
/replaceMethodTest.xml"); 
TestChangeMethod test-(TestChangeMethod) bf.getBean("testChange 
Method"); 
test.changeMe( ); 





好 了 ， 运 行 测试 类 就 可 以 看 到 预期 的 结果 了 ， 
控制 合成 功 打 印 出 “我 蔡 换 了 原 有 的 方法 "”， 也 束 是 
说 我 们 做 到 了 动态 蔡 换 原 有 方法 ， 知 道 了 这 个 元 素 
的 用 法 ， 我 们 再 次 来 看 元 素 的 提取 过 程 : 














public void parseReplacedMethodSubElements(Element beanEle, Met 
hodOverrides overrides) ( 

NodeList nl = beanEle.getChildNodes(); 

for (int i = 0; i < nl.getLength(); i++) { 


Node node - nl.item(i); 
// 仅 当 在 Spring 默认 bean 的 子 元 素 下 且 为 <replaced-method 时 








有 效 





if (isCandidateElement(node) && nodeNameEquals(nod 
e, REPLACED METHOD 
ELEMENT)) { 
Element replacedMethodEle - (Element) node; 
// 提 取 要 蔡 换 的 旧 的 方法 
String name = replacedMethodEle.getAttribute(N 











AME ATTRIBUTE); 





// 提 取 对 应 的 新 的 蔡 换 方法 

String callback = replacedMethodEle.getAttribu 
te(REPLACER ATTRIBUTE); 

ReplaceOverride replaceOverride - new ReplaceO 
verride(name, callback); 


I 


List«Element» argTypeEles - DomUtils.getChildE 
lementsByTagName 
(replacedMethodEle, ARG TYPE ELEMENT); 
for (Element argTypeEle : argTypeEles) { 
// 记 录 参 数 
String match = argTypeEle.getAttribute (AR 
G TYPE MATCH ATTRIBUTE); 
match - (StringUtils.hasText(match) ? matc 
h : DomUtils.getTextValue (argTypeEle)); 
if (StringUtils.hasText(match)) { 
replaceOverride.addTypeldentifier(matc 
h); 
} 
} 


replaceOverride.setSource(extractSource(replac 
edMethodEle)); 
overrides.addOverride(replaceOverride); 


j 








我 们 可 以 看 到 无 论 是 look-up 还 是 replaced- 
method 都 是 构造 了 一 个 MethodOverride， 并 最 终 记 
录 在 了 AbstractBeanDefinition 中 的 methodOverrides 


属性 中 。 而 这 个 属性 如 何 使 用 以 完成 它 所 提供 的 功 
能 我 们 会 在 后 续 的 章节 进行 详细 的 介绍 。 


6. 解析 子 元 系 constructor-arg 





对 构造 函数 的 解析 是 非 第 第 用 的 ， 同 时 也 古 非 
党 复杂 的 ， 也 相信 大 家 对 构造 函数 的 配置 都 不 了 
生 ， 举 个 简单 的 小 例子 : 





<beans> 
«1-- 默认 的 情况 下 是 按照 参数 的 顺序 注入 ， 当 指定 jndex 索 引 后 就 可 以 改变 注 
入 参数 的 顺序 - -> 
«bean id-"helloBean" class="com.HelloBean"> 
«constructor-arg index="0"> 











«value»jift«/value» 
</constructor-arg> 
<constructor-arg index="1"> 

<value> 你 好 </value> 
</constructor-arg> 

</bean> 


</beans> 











上 面 的 配置 是 Spring 构造 函数 配置 中 最 基础 的 
配置 ， 实 现 的 功能 束 是 对 HelloBean 上 自动 寻找 对 应 的 
构造 函数 ， 并 在 初始 化 的 时 候 将 设置 的 参数 传 入 进 
去 。 那 么 让 我 们 来 看 看 具体 的 XML 解析 过 程 。 








X) T constructor-arg T ICA HJ pr, Springze38 
i parseConstructorArgElements Pi BOK SLEW, LS 


的 代码 如 下 : 


public void parseConstructorArgElements(Element beanEle, B 
eanDefinition bd) ( 
NodeList nl = beanEle.getChildNodes(); 
for (int i = 0; i < nl.getLength(); i++) { 
Node node = nl.item(i); 
if (isCandidateElement(node) && nodeNameEquals(nod 
e, CONSTRUCTOR_ARG_ELEMENT)) { 
// 解 析 constructor-arg 
parseConstructorArgElement 





((Element) node, bd); 


j 





xx RAE BOTTA ARE RRS SB, 3m D; PUR T 
TA., LIE DÉBUT constructor-arg, ZAJA XETI f 
析 ， 但 是 具体 的 解析 却 被 放置 在 了 另 个 函数 
parseConstructorArgElement 中 ， 具 体 代码 如 下 : 











public void parseConstructorArgElement(Element ele, BeanDefinit 
ion bd) { 
// 提 取 index 属 性 
String indexAttr = ele.getAttribute(INDEX ATTRIBUTE); 
// 提 取 type 属 性 
String typeAttr = ele.getAttribute(TYPE ATTRIBUTE); 
// 提 取 name 属 性 
String nameAttr = ele.getAttribute(NAME ATTRIBUTE); 
if (StringUtils.hasLength(indexAttr)) { 
try { 
int index = Integer.parselInt(indexAttr); 
if (index « 0) { 
error("'index' cannot be lower than 0", el 








e); 
jelse ( 


try { 
this.parseState.push(new ConstructorAr 


gumentEntry(index)); 





// 解 析 ele 对 应 的 属性 元 素 
Object value = parsePropertyValue 


—= 








(ele, bd, null); 
ConstructorArgumentValues.ValueHolder 
valueHolder - new 
ConstructorArgumentValues.ValueHolder(value); 
if (StringUtils.hasLength(typeAttr)) { 
valueHolder.setType(typeAttr); 


if (StringUtils.hasLength(nameAttr)) { 
valueHolder.setName(nameAttr); 


valueHolder.setSource(extractSource(el 


e)); 





// 不 允许 重复 指定 相同 参数 
if (bd.getConstructorArgumentValues(). 
hasIndexedArgumentValue 
(index)) { 
error("Ambiguous constructor-arg e 
ntries for index " + 
index, ele); 
jelse ( 
bd.getConstructorArgumentValues(). 
AddIndexedArgumentValue 


(index, valueHolder); 


} 
}finally { 
this.parseState.pop(); 
} 


}catch (NumberFormatException ex) { 
error("Attribute 'index' of tag 'constructor-a 
rg' must be an integer", ele); 














} 

jelse { 
// 没 有 index 属 性 则 忽略 去 属性 ， 自 动 寻 找 
try { 


this.parseState.push(new ConstructorArgumentEn 
try()); 


Object value - parsePropertyValue(ele, bd, nul 
1); 
ConstructorArgumentValues.ValueHolder valueHol 
der = new Constructor- 
ArgumentValues.ValueHolder(value); 
if (StringUtils.hasLength(typeAttr)) { 
valueHolder.setType(typeAttr); 


} 
if (StringUtils.hasLength(nameAttr)) { 
valueHolder.setName(nameAttr); 


valueHolder.setSource(extractSource(ele)); 
bd.getConstructorArgumentValues().addGenericAr 
gumentValue 


(valueHolder); 


} 
finally { 
this.parseState.pop(); 





上 面 一 段 看 似 复 杂 的 代码 让 很 多 人 失去 了 而 











心 ， 但 是 ， 涉 及 的 逻辑 其 实 并 不 复杂 ， 首 先是 提取 
constructor-arg 上 必要 的 属性 Cindex. type. 
name) 。 


e 如 果 配 置 中 指定 了 index 属 性 ， 那 么 操作 步骤 如 
下 。 


1. 解析 Constructor-arg 的 子 元 素 。 


2. TER] 





ConstructorArgumentValues. V alueHolder2 789 KA 28: 


解析 出 来 的 元 素 。 


3. 将 type、name 和 index 属 性 一 并 封装 在 
ConstructorArgumentValues. ValueHolder28 44 FFF Ys 
加 至 当前 BeanDefinition 的 
constructorArgumentValues 的 
indexedArgumentValues 属 性 中 。 


。 如 采 没 有 指定 index 属 性 ， 那 么 操作 步骤 如 下 。 
1. 解析 constructor-arg 的 子 元 素 。 
2. 使 用 


ConstructorArgumentValues.ValueHolder 类 型 来 封装 


解析 出 来 的 元 素 。 


3. 将 type、name 和 index 属 性 一 并 封装 在 
ConstructorArgumentValues. ValueHolderZ$ 44 FFF Ys 
加 至 当前 BeanDefinition 的 
constructorArgumentValues 的 genericArgumentValues 


属性 中 。 


可 以 看 到 ， 对 于 是 仿制 定 imdex 属 性 来 讲 ， 
Spring 的 处 理 流程 是 不 同 的 ， 关 键 在 于 属性 信息 被 
保存 的 位 置 。 





那么 了 解 了 整个 流程 后 ， 我 们 笃 试 看 进一步 了 
解 解析 构造 函数 配置 中 子 元 系 的 过 程 ， 进 入 


parsePropertyValue: 





public Object parsePropertyValue(Element ele, BeanDefinition bd 
, String propertyName) { 
String elementName - (propertyName !- null) ? 
"<property> element for property '" + 


propertyName + "'" 
"<constructor-arg> element"; 


// 一 个 属性 只 能 对 应 一 种 类 型 ， ref、value、1ist 等 
NodeList nl = ele.getChildNodes(); 
Element subElement - null; 
for (int i = 0; i < nl.getLength(); i++) { 
Node node = nl.item(i); 
// 对 应 description 或 者 meta 不 处 理 
if (node instanceof Element && !nodeNameEquals(nod 
e, DESCRIPTION ELEMENT) && 
!nodeNameEquals(node, META ELEMENT)) { 
if (subElement !- null) ( 
error(elementName + " must not contain mor 
e than one sub-element", ele); 


























} 
else ( 

subElement - (Element) node; 
} 


} 
// 解 析 constructor-arg 上 的 ref 属 性 
boolean hasRefAttribute = ele.hasAttribute(REF ATTRIBU 


—= 














TE)? 

// 解 析 constructor-arg 上 的 value 属 性 

boolean hasValueAttribute = ele.hasAttribute(VALUE ATT 
RIBUTE); 


if ((hasRefAttribute && hasValueAttribute) || 
((hasRefAttribute || hasValueAttribute) && sub 
Element !- null)) ( 
Ya 


* #Econstructor-arg LAE: 
* 1. 同时 既 有 ref 属 性 又 有 value 属 性 
2. 存在 ref 属 性 或 者 value 属 性 且 又 有 子 元 素 



































Tf 
error(elementName + 
" is only allowed to contain either 'ref' 
attribute OR 'value' 
attribute OR sub-element", ele); 


j 


if (hasRefAttribute) { 
//ref 属 性 的 处 理 ， 使 用 RuntimeBeanReference 封 装 对 应 的 ref 























名 称 
String refName = ele.getAttribute(REF ATTRIBUTE); 
if (!StringUtils.hasText(refName)) ( 
error(elementName + " contains empty 'ref' att 
ribute", ele); 
} 
RuntimeBeanReference ref = new RuntimeBeanReferenc 
e(refName); 
ref.setSource(extractSource(ele)); 
return ref; 
jelse if (hasValueAttribute) { 
//value 属 性 的 处 理 ， 使 用 TypedStringValue 封 装 
TypedStringValue valueHolder = new TypedStringValu 
e (ele.getAttribute 
(VALUE ATTRIBUTE)); 
valueHolder.setSource(extractSource(ele)); 
return valueHolder; 
jelse if (subElement !- null) { 
// 解 析 子 元 素 
return parsePropertySubElement(subElement, bd); 
jelse ( 
/V/ 既 没有 ref 也 没有 value 也 没有 子 元 素 ，Spring 蒙 图 了 
error(elementName + " must specify a ref or value" 









































return null; 





从 代码 上 来 看 ， 对 构造 函数 中 属性 元 系 的 解 
析 ， 经 历 了 以 下 几 个 过 程 。 


1. 略 过 description 或 者 meta。 

2. 提取 constructor-arg 上 的 ref 和 value 属 性 ， 以 
便于 根据 规则 验证 正确 性 ， 其 规则 为 在 constructor- 
arg 上 不 存在 以 下 情况 。 


。 辣 时 既 有 ref 属 性 又 有 value 属 性 。 
。 存 在 ref 属 性 或 者 value 属 性 且 又 有 子 元 素 。 


3. ref 属 性 的 处 理 。 使 用 RuntimeBeanReference 
封装 对 应 的 ref 名 称 ， 如 : 


«constructor-arg ref="a" > 


4. value 属 性 的 处 理 。 使 用 TypedStringValue 封 
A, 如 : 


«constructor-arg value="a" > 


D. T JURE ANE, 如 : 














<constructor-arg> 
<map> 
«entry key="key" value="value" /> 


</map> 
</constructor-arg> 








而 对 于 子 元 系 的 处 理 ， 例 如 这 里 提 到 的 在 构造 
国 数 中 又 磐 入 了 子 元 素 map 是 怎么 实现 的 呢 ? 
parsePropertySubElement 中 实现 了 对 各 种 子 元 素 的 
分 类 处 理 。 








public Object parsePropertySubElement(Element ele, BeanDefiniti 
on bd) ( 
return parsePropertySubElement 


(ele, bd, null); 
} 


public Object parsePropertySubElement(Element ele, BeanDefiniti 
on bd, String defaultValueType) { 
if (!isDefaultNamespace(ele)) ( 
return parseNestedCustomElement(ele, bd); 
else if (nodeNameEquals(ele, BEAN ELEMENT)) { 
BeanDefinitionHolder nestedBd - parseBeanDefinitio 
nElement(ele, bd); 
if (nestedBd !- null) { 
nestedBd = decorateBeanDefinitionlIfRequired(el 
e, nestedBd, bd); 


return nestedBd; 
} 
else if (nodeNameEquals(ele, REF ELEMENT)) { 


// A generic reference to any name of any bean. 
String refName - ele.getAttribute(BEAN REF ATTRIBU 








TE); 
boolean toParent - false; 
if (!StringUtils.hasLength(refName)) { 
// 解 析 local 
refName = ele.getAttribute(LOCAL REF ATTRIBUTE 
); 
if (!StringUtils.hasLength(refName)) { 
// 解 析 parent 
refName = ele.getAttribute(PARENT_REF_ATTR 
IBUTE); 


toParent - true; 
if (!StringUtils.hasLength(refName)) { 


error("'bean', 'local' or 'parent' is 
required for «ref» element", ele); 
return null; 
} 
} 


} 
if (!StringUtils.hasText(refName)) ( 
error("<ref> element contains empty target att 
ribute", ele); 
return null; 
} 
RuntimeBeanReference ref = new RuntimeBeanReferenc 
e(refName, toParent); 
ref.setSource(extractSource(ele)); 
return ref; 





} 

// 对 idref 元 素 的 解析 

else if (nodeNameEquals(ele, IDREF ELEMENT)) { 
return parseIdRefElement(ele); 








} 

// 对 value 子 元 素 的 解析 

else if (nodeNameEquals(ele, VALUE ELEMENT)) { 
return parseValueElement(ele, defaultValueType); 








} 
// 对 null 子 元 素 的 解析 
else if (nodeNameEquals(ele, NULL ELEMENT)) { 
// It's a distinguished null value. Let's wrap it 
in a TypedStringValue 
// object in order to preserve the source location 





TypedStringValue nullHolder - new TypedStringValue 
(null); 

nullHolder.setSource(extractSource(ele)); 

return nullHolder; 














} 

else if (nodeNameEquals(ele, ARRAY ELEMENT)) ( 
// 解 析 array 子 元 素 
return parseArrayElement(ele, bd); 

} 

else if (nodeNameEquals(ele, LIST ELEMENT)) { 
// 解 析 1ist 子 元 素 
return parseListElement(ele, bd); 

} 


else if (nodeNameEquals(ele, SET ELEMENT)) { 
// 解 析 set 子 元 素 








return parseSetElement(ele, bd); 


else if (nodeNameEquals(ele, MAP ELEMENT)) { 
// 解 析 map 子 元 素 
return parseMapElement(ele, bd); 














} 

else if (nodeNameEquals(ele, PROPS ELEMENT)) { 
// 解 析 props 子 元 素 
return parsePropsElement(ele); 

} 

else { 


error ("Unknown property sub-element: [" + ele.getN 
odeName() + "]", ele); 
return null; 


j 








可 以 看 到 ， 在 上 和 面 的 函数 中 实现 了 所 有 可 文 持 





的 子 类 的 分 类 处 理 ， 到 这 里 ， 我 们 已 经 大 致 理 清 构 
造 函 数 的 解析 流程 ， 至 于 更 深入 的 解析 读者 有 兴趣 
可 以 自己 去 探索 。 

7. MENT T 70% property 


parsePropertyElement K Zi 5c jV, f Xj property /& 





性 的 提取 ，property 使 用 方式 如 下 : 


«bean id="test" class="test.TestClass"> 
<property name="testStr" value="aaa"/> 
</bean> 





«bean id-z"a"» 
«property name="p"> 
«list» 
<value>aa</value> 
<value>bb</value> 


</list> 
</property> 
</bean> 





其 体 的 解析 过 程 如 下 : 


public void parsePropertyElements(Element beanEle, BeanDefiniti 
on bd) { 
NodeList nl = beanEle.getChildNodes(); 
for (int i = 0; i < nl.getLength(); i++) { 
Node node = nl.item(i); 
if (isCandidateElement(node) && nodeNameEquals(nod 
e, PROPERTY ELEMENT)) ( 
parsePropertyElement 


((Element) node, bd); 


j 





有 了 之 前 分 析 构 造 函 数 的 经 验 ， 这 个 函数 我 们 
ee 无 非 是 提取 所 有 property 的 子 元 素 ， 
然后 调用 parsePropertyElement 处 理 ， 
parsePropertyElement 代 人 码 如 下 : 








public void parsePropertyElement(Element ele, BeanDefinition bd 


J^ 

















// 获 取 配 置 元 素 中 name 的 值 
String propertyName = ele.getAttribute(NAME ATTRIBUTE) 


if (!StringUtils.hasLength(propertyName)) { 
error("Tag 'property' must have a 'name' attribute 





", ele); 
return; 
} 
this.parseState.push(new PropertyEntry(propertyName)); 
try { 
// 不 允许 多 次 对 同一 属性 配置 
if (bd.getPropertyValues().contains(propertyName)) 
{ 
error("Multiple 'property' definitions for pro 
perty '" + propertyName + "'", ele); 


return; 
Object val = parsePropertyValue 


(ele, bd, propertyName) ; 
PropertyValue pv = new PropertyValue(propertyName, 


val); 
parseMetaElements(ele, pv); 
pv.setSource(extractSource(ele)); 
bd.getPropertyValues().addPropertyValue 
(pv); 
} 
finally { 
this.parseState.pop(); 
} 
} 





可 以 看 到 上 面 函 效 与 构造 函数 注入 方式 不 同 的 





是 将 返回 值 使 用 PropertyValue 进 行 封装 ， 并 记录 在 
了 BeanDefinition 中 的 propertyValues 属 性 中 。 


8. 解析 子 元 素 qualifier 


对 于 qualifier 元 系 的 获取 ， 我 们 接触 更 多 的 是 





注解 的 形式 ， 在 使 用 Spring 框架 中 进行 自动 注入 
时 ，Spring 容 器 中 匹配 的 候选 Bean 数 目 必 须 有 且 仪 
有 一 个 。 当 找 不 到 一 个 匹配 的 Bean 时 ，Spring 容 项 
将 抛 出 BeanCreationException 异 常 ， 并 指出 必须 至 
少 拥有 一 个 匹配 的 Bean。 


Spring 允许 我 们 通过 Qualifier 指 定 注 入 Bean 的 
名 称 ， 这 样 政 义 束 消除 了 ， 而 对 于 配置 方式 使 用 
A: 


«bean id="myTestBean" class="bean.MyTestBean"> 
<qualifier type="org.Springframework.beans.factory.annotati 


on.Qualifier" value="qf"/> 
</bean> 
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3.1.2 AbstractBeanDefinition)= tt 


至 此 我 们 便 完 成 了 对 XML 文档 到 
GenericBeanDetfinition 的 转换 ， 也 就 是 说 到 这 里 ， 
XML 中 所 有 的 配置 都 可 以 在 GenericBeanDefinition 
的 实例 类 中 找到 对 应 的 配置 。 


GenericBeanDefinition 只 是 子 类 实现 ， 而 大 部 





分 的 通用 属性 都 保存 在 了 AbstractBeanDefinition 
中 ， 那 么 我 们 再 次 通过 AbstractBeanDefinition 的 属 
性 来 回顾 一 下 我 们 都 解析 了 哪些 对 应 的 配置 。 








public abstract class AbstractBeanDefinition extends BeanMetada 
taAttributeAccessor 
implements BeanDefinition, Cloneable ( 





























// 此 处 省 略 静态 变量 以 及 final1 常 量 





























/** 

* bean 的 作用 范围 , 对 应 bean 属 性 scope 

*/ 
private String scope = SCOPE DEFAULT; 
VON 

* 是 否 是 单 例 ,来 自 bean 属 性 scope 

*/ 
private boolean singleton - true; 
fre 

* 是 否 是 原型 ,来 自 bean 属 性 scope 

*/ 
private boolean prototype = false; 
/** 

* 是 否 是 抽象 ， 对 应 pean 属 性 abstract 

人 
private boolean abstractFlag = false; 
Vaso 

* 是 否 延 迟 加 载 , 对 应 bean 属 性 lazy-init 

i 


private boolean lazyInit - false; 


/** 
* 自动 注入 模式 , 对 应 bean 属 性 autowire 
pA 





private int autowireMode = AUTOWIRE_NO; 


/** 
* 依赖 检查 ，Spring 3.0 后 弃 用 这 个 属性 





"f 
private int dependencyCheck - DEPENDENCY CHECK NONE; 
/** 
* 用 来 表示 一 个 bean 的 实例 化 依靠 另 一 个 bean 先 实例 化 ,对 应 bean 属 性 depe 
nd-on 
£y 
private String[] dependsOn; 








LES 
* autowire-candidate 属 性 设置 为 false， 这 样 容器 在 查找 自动 装配 对 象 


时 ， 
* 将 不 考虑 该 bean， 即 它 不 会 被 考虑 作为 其 他 bean 自 动 装 配 的 候选 者 ， 但 是 
该 bean 本 身 还 是 可 以 使 用 自动 装配 来 注入 其 他 bean 的 。 
* ”对 应 bean 属 性 autowire-candidate 
*J 
private boolean autowireCandidate - true; 


















































/** 
* 自动 装配 时 当 出 现 多 个 bean 候 选 者 时 ， 将 作为 首选 者 ,对 应 bean 属 性 prima 

















ry 
*/ 
private boolean primary - false; 


fre 
* 用 于 记录 Qualifier， 对 应 子 元 素 qualLifier 
*/ 
private final Map<String, AutowireCandidateQualifier> qual 
ifiers = 





new LinkedHashMap<String, AutowireCandidateQualifi 
er>(0); 


/** 
* 人 允许 访问 非 公开 的 构造 器 和 方法 ， 程 序 设置 
*/ 





private boolean nonPublicAccessAllowed = true; 


* 


/ 





是 否 以 一 种 宽松 的 模式 解析 构造 函数 ， 默 认为 true， 
如 果 为 false, 则 在 如 下 情况 
interface ITest{} 
class ITestiImpl implements ITest{}; 
class Main( 

Main(ITest i){} 

Main(ITestImpl i){} 
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* 抛 出 异常 ， 因 为 Spring 无 法 准确 定位 哪个 构造 函数 

* 程序 设置 

*/ 

private boolean lenientConstructorResolution = true; 



































/** 
* 记录 构造 函数 注入 属性 ， 对 应 pean 属 性 constructor-arg 
* ff 
private ConstructorArgumentValues constructorArgumentValue 
S; 
/** 
* 普通 属性 集合 
*/ 
private MutablePropertyValues propertyValues; 
/** 
* 方法 重 写 的 持 有 者 ,记录 lookup-method、replaced-method 元 素 
A 


private MethodOverrides methodOverrides = new MethodOverri 
des(); 


JER 
* 对 应 bean 属 性 factory-bean， 用 法 : 
* <bean id="instanceFactoryBean" class="example.chapter3. 
InstanceFactoryBean"/> 
* <bean id="CurrentTime" factory-bean="instanceFactoryBean 
" factory-methodz" 
createTime"/> 

















iA 
private String factoryBeanName; 
Ves 
* 对 应 bean 属 性 factory-method 
i 
private String factoryMethodName; 
/** 
* 初始 化 方法 ， 对 应 bean 属 性 init-method 
M 


private String initMethodName; 


/** 
* 销毁 方法 ， 对 应 pean 属 性 destory-method 








*/ 
private String destroyMethodName; 


/** 

* 是 否 执行 init-method， 程 序 设 置 

*/ 

private boolean enforceInitMethod = true; 
/** 

* 是 否 执行 destory-method， 程 序 设置 

*/ 


private boolean enforceDestroyMethod = true; 


/** 
* 是 否 是 用 户 定义 的 而 不 是 应 用 程序 本 身 定义 的 ,创建 AOP 时 候 为 true， 程 序 














private boolean synthetic = false; 


/** 

* 定义 这 个 bean 的 应 用 . APPLICATION: H), INFRASTRUCTURE: 完全 
内 部 使 用 ， 与 用 户 无 关 ， SUPPORT: 某 些 复杂 配置 的 一 部 分 

* 程序 设置 

x 

private int role = BeanDefinition.ROLE APPLICATION; 





/** 
* bean 的 描述 信息 
*/ 
private String description; 
SNS 
* 这 个 bean 定 义 的 资源 
*/ 
private Resource resource; 




















// 此 处 省 略 set/get 方 法 
} 





3.1.3 ”解析 默认 标签 中 的 自 定义 标签 元 素 


PIR HL AL C. e M Y T) PTS ts SE I ENT 
提取 过 程 ， 或 许 涉 及 的 内 容 太 多 ， 我 们 已 经 起 了 我 
们 从 哪个 函数 开始 的 了 ， 我 们 再 次 回顾 下 献 认 标签 
解析 函数 的 起 始 函 数 : 


protected void processBeanDefinition(Element ele, BeanDefinitio 
nParserDelegate delegate) { 

BeanDefinitionHolder bdHolder - delegate.parseBeanDefi 
nitionElement 


(ele); 
if (bdHolder !- null) ( 
bdHolder = delegate.decorateBeanDefinitionlIfRequir 
ed 


(ele, bdHolder); 


try { 
// Register the final decorated instance. 


BeanDefinitionReaderUtils.registerBeanDefiniti 
on 


(bdHolder, getReader 
Context().getRegistry()); 


catch (BeanDefinitionStoreException ex) ( 
getReaderContext().error("Failed to register b 
ean definition with name '" + 
bdHolder.getBeanName() + "'", ele, ex) 


j 


// Send registration event. 
getReaderContext().fireComponentRegistered 


(new BeanComponentDefinition 
(bdHolder)); 
} 


} 











我 们 已 经 用 了 大 量 的 篇 幅 分 析 了 
BeanDefinitionHolder bdHolder = delegate.parseBean- 
DefinitionElement(ele) 这 人 句 代 人 码 ， 接 下 来 ， 我 们 要 进 
fTbdHolder = delegate.decorateBean- 
DefinitionIfRequired(ele, bdHolder){QiS Ha AT, Ei 
先 大 致 了 解 下 这 句 代码 的 作用 ， 其 实 我 们 可 以 从 语 
义 上 分 析 : 如 果 和 需要 的 话 束 对 beanDefinition 进 行 装 
Tih, ABIX ALAS BIER ETT A RENE? 其 实 这 句 代 码 
适用 于 这 样 的 场景 ， 如 : 


«bean id="test" class="test.MyClass"> 
<mybean:user username="aaa"/> 


</bean> 





当 Spring 中 的 bean 使 用 的 是 默认 的 标 俭 配置 ， 
但 是 其 中 的 子 元 素 却 使 用 了 目 定 义 的 配置 时 ， 这 人 名 
代码 便 会 起 作用 了 。 可 能 有 人 会 有 疑问 ， 之 前 讲 
过 ， 对 bean 的 解析 分 为 两 种 类 型 ， 一 种 是 默认 类 型 
的 解析 ， 男 一 种 是 自 定义 类 型 的 解析 ， 这 不 正 是 目 
定义 类 型 的 解析 吗 ? 为 什么 会 在 默认 类 型 解析 中 单 
独 添加 一 个 方法 处 理 呢 ? 确实 ， 这 个 问题 很 让 人 迷 
惑 ， 但 是 ， 不 知道 聪明 的 读者 是 否 有 有 发现， 这 个 目 
定义 类 型 并 不 是 以 Bean 的 形式 出 现 的 呢 ? 我 们 之 前 
讲 过 的 两 种 类 型 的 不 同 处 理 只 是 针对 Bean 的 ， 这 里 
我 们 看 到 ， 这 个 目 定 义 类 型 其 实 是 属性 。 好 了 ， 我 
们 继续 分 析 下 这 段 代 人 码 的 逻辑 。 





public BeanDefinitionHolder decorateBeanDefinitionlIfRequired(El 
ement ele, BeanDefinitionHolder 
definitionHolder) { 

return decorateBeanDefinitionIfRequired 


(ele, definitionHolder, null); 


j 





这 里 将 函数 中 第 三 个 参数 设置 为 空 ， 那 么 第 三 
个 参数 是 做 什么 用 的 昵 ? 什么 情况 下 不 为 空 呢 ? 其 
实 这 第 三 个 参数 是 父 类 bean， 当 对 某 个 嵌 套 配置 进 
行 分 析 时 ， 这 里 需要 传递 父 类 beanDefinition。 分 析 
源码 得 知 这 里 传递 的 参数 其 实 是 为 了 使 用 父 类 的 
scope 属 性 ， 以 备 子 类 知 没 有 设置 scope 时 默认 使 用 
父 类 的 属性 ， 这 里 分 析 的 是 顶层 配置 ， 所 以 传递 
null。 将 第 三 个 参数 设置 为 空 后 进一步 跟踪 函数 : 














public BeanDefinitionHolder decorateBeanDefinitionIfRequired( 
Element ele, BeanDefinitionHolder definitionHolder, BeanDe 
finition containingBd) { 


BeanDefinitionHolder finalDefinition = definitionH 
older; 


NamedNodeMap attributes = ele.getAttributes(); 
/ DI JPUR RS STE, Bae Baie Ae RTE 
for (int i = 0; i < attributes.getLength(); i++) { 
Node node = attributes.item(i); 
finalDefinition = decorateIfRequired 





—= 

















(node, finalDefinition, containingBd); 


j 


NodeList children = ele.getChildNodes(); 
/ EAI POR, Bea AI T ETE T TOR 

















for (int i = 0; i < children.getLength(); i++) { 
Node node = children.item(i); 
if (node.getNodeType() == Node.ELEMENT_NODE) { 
finalDefinition = decorateIfRequired 


(node, finalDefinition, 
containingBd); 


j 


return finalDefinition; 





上 面 的 代码 ， 我 们 看 到 函数 分 别 对 元 素 的 所 有 
属性 以 及 子 节 点 进行 了 decorateIfRequired 函 数 的 调 
用 ， 我 们 继续 跟踪 代码 : 





private BeanDefinitionHolder decoratelIfRequired( 


Node node, BeanDefinitionHolder originalDef, BeanDefin 
ition containingBd) { 


// 获 取 自 定义 标签 的 命名 空间 
String namespaceUri = getNamespaceURI 





(node); 
// 对 于 非 默 认 标签 进行 修饰 
if (!isDefaultNamespace 





(namespaceUri)) { 
// 根 据 命 名 空间 找到 对 应 的 处 理 器 
NamespaceHandler handler-this.readerContext. getNa 
mespaceHandler Resolver(). resolve(namespaceUri); 
if (handler != null) { 
// 进 行 修饰 




















return handler.decorate(node, originalDef, new 
ParserContext(this.readerContext, this, containingBd)); 


else if (namespaceUri !- null && namespaceUri.star 
tswith("http://www. 


springframework.org/")) { 


error("Unable to locate Spring NamespaceHandle 
r for XML schema 
namespace [" + namespaceUri + "]", node); 


else ( 
// A custom namespace, not to be handled by Sp 
ring - maybe "xml:...". 
if (logger.isDebugEnabled()) (1 
logger.debug("No Spring NamespaceHandler f 
ound for XML schema 
namespace [" + namespaceUri + "]|"); 
} 
小 


return originalDef; 


j 


public String getNamespaceURI(Node node) { 
return node.getNamespaceURI(); 
} 


public boolean isDefaultNamespace(String namespaceUri) { 
//BEANS NAMESPACE URI = "http://www.springframework.or 
g/schema/beans" ; 
return (!StringUtils.hasLength(namespaceUri) || BEANS. 
NAMESPACE URI.equals 
(namespaceUri)); 





程序 走 到 这 里 ， 条 理 其 实 已 经 非常 清楚 了 了， 前 








先 获取 属性 或 者 元 系 的 命名 空间 ， 以 此 来 判断 该 元 
系 或 者 属性 是 否 适 用 于 自 定 义 标签 的 解析 条 件 ， 找 
出 目 定 义 类 型 所 对 应 的 NamespaceHandler 并 进行 进 
一 步 解 析 。 在 目 定 义 标签 解析 的 章节 我 们 会 重点 讲 
解 ， 这 里 暂时 先 略 过 。 


我 们 总 绪 下 decorateBeanDefinitionIfRequired 方 





法 的 作用 ， 在 decorateBeanDefinitionIfRequired 中 我 
们 可 以 看 到 对 于 程序 默认 的 标 釜 的 处 理 其 实 是 直接 
略 过 的 ， 因 为 默认 的 标签 到 这 里 已 经 被 处 理 完了 ， 
这 里 只 对 目 定 义 的 标签 或 者 说 对 bean 的 目 定 义 属性 
感 兴趣 。 在 方法 中 实现 了 寻找 自 定 义 标签 并 根据 目 
大 命名 空间 处 理 器 ， 并 进行 进一步 的 解 
Vie 








3.1.4 ”注册 解析 的 BeanDefinition 


对 于 配置 文件 ， 解 析 也 解析 完了 ， 装 饰 也 装饰 
完了 ， 对 于 得 到 的 beanDinition 已 经 可 以 满足 后 续 的 
使 用 要 求 了 ， 唯 一 还 剩 下 的 工作 融 是 注册 了 ， 也 残 
= processBeanDefinition K 20 P H3 
BeanDefinitionReaderUtils.registerBeanDefinition(bdH 
getReaderContext().getRegistry() 代 码 的 解析 了 。 





public static void registerBeanDefinition( 

BeanDefinitionHolder definitionHolder, BeanDefinit 
ionRegistry registry) 

throws BeanDefinitionStoreException { 


// 使 用 beanName 做 唯一 标识 注册 
String beanName = definitionHolder.getBeanName(); 
registry.registerBeanDefinition 


(beanName, definitionHolder.getBeanDefinition()); 
// 注 册 所 有 的 别名 


String[] aliases = definitionHolder.getAliases(); 
if (aliases !- null) { 





for (String aliase : aliases) ( 
registry.registerAlias 


(beanName, aliase); 


j 
J 
} 





从 上 面 的 代码 可 以 看 出 ， 解 析 的 beanDefinition 
都 会 被 注册 到 BeanDefinitionRegistry 类 型 的 实例 
registry 中 ， 而 对 于 beanDefinition 的 注册 分 成 了 两 部 
4]: 通过 beanName 的 注册 以 及 通过 别名 的 注册 。 


1. 通过 beanName 注 册 BeanpDefinition 


对 于 beanDefinition 的 注册 ， 或 许 很 多 人 认为 的 
方式 就 是 将 beanDefinition 直 接 放 入 map 中 就 好 了 ， 
使 用 beanName 作 为 key。 实 ，Spring 就 是 这 么 做 
的 ， 只 不 过 除 此 之 外 ， 它 还 做 了 点 别 的 事情 。 








public void registerBeanDefinition(String beanName, BeanDefinit 
ion beanDefinition) 


throws BeanDefinitionStoreException ( 


Assert.hasText(beanName, "Bean name must not be empty" 


); 
Assert.notNull(beanDefinition, "BeanDefinition must no 
t be null"); 


if (beanDefinition instanceof AbstractBeanDefinition) 


try { 
/* 





* 注册 前 的 最 后 一 次 校 验 ， 这 里 的 校 验 不 同 于 之 前 的 XML 文件 


校 验 ， 





* 主要 是 对 于 AbstractBeanDefinition 属 性 中 的 method 





Overrides 校 验 ， 





* 校 验 methodoverrides 是 否 与 工厂 方法 并 存 或 者 method0 
verrides 对 应 的 方法 根本 不 存在 
*/ 
((AbstractBeanDefinition) beanDefinition).vali 








date(); 


catch (BeanDefinitionValidationException ex) { 
throw new BeanDefinitionStoreException (beanDe 
finition. getResource 
Description(), beanName, 
"Validation of bean definition failed" 
, ex); 


j 


} 
// 因 为 beanDefinitionMap 是 全 局 变量 ， 这 里 定 会 存在 并 发 访问 的 情况 
synchronized (this.beanDefinitionMap) { 

Object oldBeanDefinition - this.beanDefinitionMap. 

get(beanName); 
// 处 理 注册 已 经 注册 的 beanName 情 况 
if (oldBeanDefinition !- null) ( 
// 如 果 对 应 的 BeanName 己 经 注册 且 在 配置 中 配置 了 bean 不 允 
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if (!this.allowBeanDefinitionOverriding) { 
throw new BeanDefinitionStoreException(bea 
nDefinition. getResource 
Description(), beanName, 
"Cannot register bean definition [ 
" + beanDefinition + "] for bean '" + beanName + 
"!: There is already [" + oldBeanD 
efinition + "] bound."); 
jelse ( 
if (this.logger.isInfoEnabled()) { 
this.logger.info("Overriding bean defi 
nition for bean '" + beanName + 
"': replacing [" + oldBeanDefi 
nition + "] with [" + 
beanDefinition + "]"); 


} 
jelse { 
// 记 录 beanName 


this.beanDefinitionNames.add(beanName); 
this.frozenBeanDefinitionNames - null; 


// 注 册 beanDefinition 


this.beanDefinitionMap.put(beanName, beanDefinitio 


} 
// 重 置 所 有 beanName 对 应 的 缓存 


resetBeanDefinition(beanName); 








上 面 的 代码 中 我 们 看 到 ， 在 对 于 bean 的 注册 处 
理 方 式 上 ， 主 要 进行 了 几 个 步骤 。 


1. 对 AbstractBeanDefinition 的 校 验 。 在 解析 
XML 文件 的 时 候 我 们 提 过 校 验 ， 但 是 此 校 验 非 彼 校 
验 ， 之 前 的 校 验 时 针对 于 XML 格式 的 校 验 ， 而 此 时 
的 校 验 时 针 是 对 于 AbstractBean- Definition 的 
methodOverrides 属 性 的 。 





2. 对 beanName 己 经 注册 的 情况 的 处 理 。 如 果 
设置 了 不 允许 bean 的 绑 产 ， 则 需要 抛 出 异 第 ， 否 则 
BLS io 

3. 加 入 map 绥 存 。 


4. 清除 解析 之 前 留 下 的 对 应 beanName 的 绥 
存 。 


2. 通过 别名 注册 BeanDefinition 


在 理解 了 注册 bean 的 原理 后 ， 理 解 注册 别名 的 
原理 束 容 易 多 了 。 


public void registerAlias(String name, String alias) { 
Assert.hasText(name, "'name' must not be empty"); 
Assert.hasText(alias, "'alias' must not be empty"); 
// 如 果 beanName 与 alias 相 同 的 话 不 记录 alias, 并 删除 对 应 的 alias 
if (alias.equals(name)) { 
this.aliasMap.remove(alias); 
yelse ( 
// 如 果 alias 不 允许 被 覆盖 则 抛 出 异常 
if (!allowAliasOverriding()) (1 
String registeredName - this.aliasMap.get(alia 





s); 
if (registeredName != null && !registeredName. 
equals(name)) { 


throw new IllegalStateException("Cannot re 
gister alias '" + alias + "' for name '" + 
name + "': It is already registere 


d for name '" + 
registeredName + "'."); 


j 


} 

// 当 A->B 存 在 时 ， 若 再 次 出 现 A->C->B 时 候 则 会 抛 出 异常 
checkForAliasCircle(name, alias); 
this.aliasMap.put(alias, name); 








由 以 上 代码 中 可 以 得 知 ， 注 册 alias 的 步 又 如 
Ui 


1. alias 与 beanName 相 同情 况 处 理 。 若 alias 与 
beanName 并 名 称 相 同 则 不 需要 处 理 并 删除 挥 原 有 


alias。 





2. alias i AZ, ZraliaNNamet 2$ f$ FH3f C 
经 指向 了 另 一 beanName 则 需要 用 户 的 设置 进行 处 
fH. 


3. alias 循 环 检查 。 当 A->B 存 在 时 ， 若 再 次 出 
现 A->C->B 时 候 则 会 抛 出 异常 。 


4. 注册 alias。 
3.1.5 ”通知 监听 器 解析 及 注册 完成 


通过 代码 
getReaderContext().fireComponentRegistered(new 
BeanComponentDefinition(bdHolder)) 5& KIL LYE, 
这 里 的 实现 只 为 扩展 ， 当 程序 开 及 人 员 需 要 对 注册 
BeanDefinition 事 件 进行 监听 时 可 以 通过 注册 监听 器 
的 方式 并 将 处 理 逻 辑 写 入 监听 器 中 ， 目 前 在 Spring 
中 并 没有 对 此 事件 做 任何 多 辑 处 理 。 


3.2 alias 标 俭 的 解析 
通过 上 面 较 长 的 篇 幅 我 们 终于 分 析 完了 默认 标 


签 中 对 bean 标 签 的 处 理 ， 那 么 我 们 之 前 提 到 过 ， 对 
配置 文件 的 解析 包括 对 import 标 签 、alias 标 签 、 





bean 标 签 、beans 标 签 的 处 理 ， 现 在 我 们 已 经 完成 了 
最 重要 也 是 最 核心 的 功能 ， 其 他 的 解析 步骤 也 都 是 
围 经 第 3 个 解析 而 进行 的 。 在 分 析 了 第 3 个 解析 步骤 
后 ， 再 回 过 头 来 看 看 对 alias 标 俭 的 解析 。 


在 对 bean 进 行 定义 时 ， 除 了 使 用 id 属性 来 指定 
名 称 之 外 ， 为 了 所 供 多 个 名 称 ， 可 以 使 用 alias 标 签 
来 指定 。 而 所 有 的 这 些 名 称 都 指 疝 同一 个 bean， 在 
东 些 情况 下 所 供 别 名 非 党 有用， 比如 为 了 让 应 用 的 
每 一 个 组 件 能 更 容易 地 对 公共 组 件 进行 引用 。 


然而 ， 在 定义 bean 时 就 指定 所 有 的 别名 并 不 是 
总 是 恰当 的 。 有 时 我 们 期 望 能 在 当前 位 置 为 那些 在 
别处 定义 的 bean 引 入 别名 。 在 XML 配置 文件 中 ， 可 
用 单独 的 <alias/> 元 对 来 完成 bean 别 名 的 定义 。 如 配 
置 文件 中 定义 了 一 个 JavaBean: 














«bean id="testBean" class="com.test"/> 





要 给 这 个 JavaBean 增 加 别名 ， 以 方便 不 同 对 象 
来 调用 。 我 们 束 可 以 直接 使 用 bean 标 签 中 的 name 属 
TE: 





«bean id="testBean" name="testBean, testBean2" class="com.test"/> 





同样 ，Spring 还 有 另外 一 种 声明 别名 的 方式 : 


«bean id="testBean" class="com.test"/> 
<alias name="testBean" alias="testBean, testBean2"/> 





考虑 一 个 更 为 具体 的 例子 ， 组 件 A 在 XML 配置 

文件 中 定义 了 一 个 名 为 componentA 的 DataSource 类 
型 的 beaan， 但 组 件 B 却 想 在 其 XML 文件 中 以 

componentB 命 名 来 引用 此 bean。 而 且 在 主 程序 
MyApp 的 XML 配置 文件 中 ， 和 希望 以 myApp 的 名 字 
来 引用 此 bean。 最 后 容器 加 载 3 个 XML 文件 来 生成 
最 终 的 ApplicationContext。 在 此 情形 下 ， 可 通过 在 
配置 文件 中 添加 下 列 alias 元 素来 实现 : 


<alias name="componentA" alias="componentB"/> 
«alias name="componentA" alias-"myApp" /> 





OPE OR, BES ZAP AG ETET ait EE A 
字 来 引用 同一 个 数据 源 而 互 不 干扰 。 
在 之 前 的 划 市 已 经 讲 过 了 对 于 bean 中 name 元 系 


的 解析 ， 那 么 我 们 现在 再 来 深入 分 析 下 对 于 alias 标 
签 的 解析 过 程 。 








protected void processAliasRegistration(Element ele) { 
// 获 取 beanName 
String name = ele.getAttribute(NAME ATTRIBUTE 


); 
// 获 取 alias 
String alias = ele.getAttribute(ALIAS ATTRIBUTE 


); 
boolean valid - true; 
if (!StringUtils.hasText(name)) { 
getReaderContext().error("Name must not be empty", 


ele); 
valid - false; 
} 
if (!StringUtils.hasText(alias)) ( 
getReaderContext().error("Alias must not be empty" 
, ele); 


valid - false; 


} 
if (valid) { 
try 4 
// 注 册 alias 
getReaderContext().getRegistry().registerAlias 
(name, alias); 
} 
catch (Exception ex) { 
getReaderContext().error("Failed to register a 
lias '" + alias + 
"' for bean with name '" + name + "'", 
ele, ex); 














} 

// 别 名 注册 后 通知 监听 器 做 相应 处 理 

getReaderContext().fireAliasRegistered(name, alias 
, extractSource(ele)); 








Jj 





可 以 发 现 ， 跟 之 前 讲 过 的 bean 中 的 alias 解 析 大 
同 小 异 ， 都 是 将 别名 与 beaanName 组 成 一 对 注册 至 
registry Fo ix HL BED. 


3.3”import 标 签 的 解析 


对 于 Spring 配置 文件 的 编号， 我 想 ， 经 历 过 庞 
AMAA, ABA APRA O, KE WAC 
件 了 。 不 过 ， 分 模块 是 大 多 数 人 能 想到 的 方法 ， 但 
fe, ADP, REEM, Se. (E 
用 import 是 个 好 办 法 ， 例 如 我 们 可 以 构造 这 样 的 
Spring 配置 文件 : 


applicationContext.xml 


<?xml version="1.0" encoding="gb2312"?> 
<!DOCTYPE beans PUBLIC "-//Spring//DTD BEAN//EN" "http://www.sp 
ringframework.org/dtd/ 
Spring-beans.dtd"> 
<beans> 


«import resource="CustomerContext.xml" /> 
«import resource="systemContext.xmLl" /> 


</beans> 





applicationContext.xml 文 件 中 使 用 import 的 方式 
导入 有 模块 配置 文件 ， 以 后 大 有 新 模块 的 加 入 ， 那 
残 可 以 简单 修改 这 个 文件 了 。 这 样 大 大 简化 了 配置 
后 期 维护 的 复杂 上 度 ， 并 使 配置 模块 化 ， 易 于 管理 。 
我 们 来 看 看 Spring 是 如 何 解 析 import 配 置 文件 的 
HE ? 





protected void importBeanDefinitionResource(Element ele) ( 
// 获 取 resource 属 性 
String location = ele.getAttribute(RESOURCE ATTRIBUTE) 























// tn RA FEE esource le TER T BU CE ta] AR 
if (!StringUtils.hasText(location)) { 
getReaderContext().error("Resource location must n 
ot be empty", ele); 
return; 





u 


} 
// 解 析 系 统 属性 ， 格 式 如 : "${user.dir}" 


location = environment.resolveRequiredPlaceholders(loc 








ation); 


Set«Resource» actualResources - new LinkedHashSet«Reso 
urce>(4); 


// 判 定 1ocation 是 决定 URI 还 是 相对 URI 
boolean absoluteLocation = false; 








try { 
absoluteLocation = ResourcePatternUtils.isUrl(loca 
tion) || ResourceUtils.toURI (location).isAbsolute(); 
} 


catch (URISyntaxException ex) { 
// cannot convert to an URI, considering the locat 
ion relative 
// unless it is the well-known Spring prefix "clas 
spath*:" 
} 


// Absolute or relative? 
// 如 果 是 绝对 URI 则 直接 根据 地 址 加 载 对 应 的 配置 文件 
if (absoluteLocation) { 
try { 
int importCount = getReaderContext().getReader 
().loadBeanDefinitions (location, actualResources); 
if (logger.isDebugEnabled()) { 
logger.debug("Imported " + importCount + " 
bean definitions from URL location [" + location + "]"); 


j 

















j 


catch (BeanDefinitionStoreException ex) { 
getReaderContext().error( 
"Failed to import bean definitions fro 


m URL location [" + 
location + "]", ele, ex); 


j 


else ( 
// 如 果 是 相对 地 址 则 根据 相对 地 址 计算 出 绝对 地 址 


try { 
int importCount; 
//Resource 存 在 多 个 子 实现 类 ， 如 VfsResource、FileSys 





temResource 等 ， 

// 而 每 个 resource 的 createRelative 方 式 实现 都 不 一 样 ， 
所 以 这 里 先 使 用 子 类 的 方法 尝 

// 试 解析 

Resource relativeResource = getReaderContext() 

getResource(). Create Relative(location); 
if (relativeResource.exists()) { 
importCount - getReaderContext().getReader 

(). loadBeanDefinitions 
(relativeResource); 











actualResources.add(relativeResource); 
jelse { 
// 如 果 解 析 不 成 功 ， 则 使 用 默认 的 解析 器 ResourcePatt 











ernResolver 进 行 解析 





String baseLocation = getReaderContext().g 
etResource().getURL(). toString(); 
importCount - getReaderContext().getReader 
().1oadBeanDefinitions( 
StringUtils.applyRelativePath(base 
Location, location), 
actualResources); 


} 
if (logger.isDebugEnabled()) { 
logger.debug("Imported " + importCount + " 
bean definitions from relative location [" + location + "]|"); 


} 
} 
catch (IOException ex) { 
getReaderContext().error("Failed to resolve cu 
rrent resource location", ele, ex); 


catch (BeanDefinitionStoreException ex) { 
getReaderContext().error("Failed to import bea 
n definitions from 
relative location [" + location + "]", 
ele, ex); 


} 
} 
// 解 析 后 进行 监听 器 激活 处 理 


Resource[] actResArray = actualResources.toArray(new R 
esource[actualResources. 
size()]); 
getReaderContext().fireImportProcessed(location, actRe 
sArray, extractSource(ele)); 


j 





























上 面 的 代码 不 难 ， 相 信 配 合 注 释 会 很 好 理解 ， 





我 们 总 结 一 下 大 致 流程 便于 读者 更 好 地 梳理 ， 在 解 
析 <import 标 签 时 ，Spring 进 行 解 析 的 步骤 大 致 如 
Ta 

1. 获取 resource 属 性 所 表示 的 路 径 。 


2. 解析 路 径 中 的 系统 属性 ， 格 式 
加“${fuser.dqir}”。 


3. 判定 location 是 绝对 路 径 还 是 相对 路 径 。 


4 如果 是 绝对 路 径 则 递归 调用 bean 的 解析 过 
程 ， 进 行 另 一 次 的 解析 。 


5. 如 末 是 相对 路 径 则 计算 出 绝对 路 径 并 进行 
解析 。 


IAM ras, MENT TEA o 


3.4 tk Astbeanstp& HJ f Mr 


XT HUN XXbeansbkRAs, tie ABE HEX, 
者 至 少 接触 过 ， 非 党 类似 于 import 标 签 所 提供 的 功 
能 ， 使 用 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmilns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.Springframework.org/schema/ 

beans http://www.Springframework. org/schema/beans/Spring-beans 

.Xsd"> 





«bean id-"aa" class="test.aa"/> 
«beans» 


«/beans» 


«/beans» 





对 于 租 入 式 beans 标 签 来 讲 ， 并 没有 太 多 可 
讲 ， 与 单独 的 配置 文件 并 没有 太 大 的 差别 ， 无 非 是 
递归 调用 beans 的 解析 过 程 ， 相 信 读 者 根据 之 前 讲解 
过 的 内 容 已 经 有 能 力 理 解 其 中 的 奥秘 了 。 


RAT 目 定 义 标 签 的 解析 








在 之 前 的 章节 中 ， 我 们 提 到 了 在 Spring 中 存在 
默认 标签 与 自 定 义 标签 两 种 ， 而 在 上 一 章 中 我 们 分 
析 了 Spring 中 对 默认 标签 的 解析 过 程 ， 相 信 大 家 一 
定 已 经 有 所 感悟 。 那 么 ， 现 在 将 开始 新 的 里 程 ， 分 
析 Spring 中 自 定 义 标签 的 加 载 过 程 。 同 样 ， 我 们 还 
是 先 再 次 回顾 一 下 ， 当 完成 从 配置 文件 到 Document 
的 转换 并 提取 对 应 的 root 后 ， 将 开始 了 所 有 元 素 的 
解析 ， 而 在 这 一 过 程 中 便 开 始 了 默认 标签 与 自 定 义 
标签 两 种 格式 的 区 分 ， 函 数 如 下 : 


protected void parseBeanDefinitions(Element root, BeanDefinitio 
nParserDelegate delegate) { 
if (delegate.isDefaultNamespace(root)) ( 
NodeList nl - root.getChildNodes(); 
for (int i = 0; i < nl.getLength(); i++) { 
Node node = nl.item(i); 
if (node instanceof Element) { 
Element ele = (Element) node; 
if (delegate.isDefaultNamespace(ele)) { 
parseDefaultElement 











(ele, delegate); 


else { 
delegate.parseCustomElement 


(ele); 


j 


else ( 
delegate.parseCustomElement 





在 本 章 中 ， 所 有 的 功能 都 是 围绕 其 中 的 一 句 代 
fJdelegate.parseCustomElement(root)JF EH). ME 
面 的 函数 我 们 可 以 看 出 ， 当 Spring 拿 到 一 个 元 素 时 





站 先 要 做 的 是 根据 命名 空间 进行 解析 ， 如 果 是 默认 
的 命名 空间 ， 则 使 用 parseDefaultElement 方 法 进行 
元 素 解 析 ， 人 否则 使 用 parseCustom- Element 方 法 进行 
解析 。 在 分 析 目 定义 标签 的 解析 过 程 前 ， 我 们 先 了 
解 一 下 上 自 定 义 标 签 的 使 用 过 程 。 


41 目 定 义 标签 使 用 


在 很 多 情况 下 ， 我 们 需要 为 系统 提供 可 配置 化 
文 持 ， 简 单 的 做 法 可 以 直接 基于 Spring 的 标准 bean 
来 配置 ， 但 配置 较为 复杂 或 者 需要 更 多 丰富 控制 的 
时 候 ， 会 显得 非常 尝 拙 。 一 般 的 做 法 会 用 原生 态 的 
方式 去 解析 定义 好 的 XML 文件 ， 然 后 转化 为 配置 对 
象 。 这 种 方式 当然 可 以 解决 所 有 问题 ， 但 实现 起 来 
比较 烦琐 ， 特 别 是 在 配置 非常 复杂 的 时 候 ， 解 析 工 




















作 是 一 个 不 得 不 考虑 的 负担 。Spring 提 供 了 可 扩展 
Schema 的 文 持 ， 这 是 一 个 不 错 的 折 中 方案 ， 扩 展 
Spring 目 定 义 标签 配置 大 致 需要 以 下 几 个 步骤 《前 
提 是 要 把 Spring 的 Core 包 加 入 项 目 中 ) 。 


。 创建 一 个 需要 扩展 的 组 件 。 

。 和 定义 一 个 XSD 文件 描述 组 件 内 容 。 

。 创建 一 个 文件 ， 实 现 BeanDefinitionParser 接 口 ， 
用 来 解析 XSD 文件 中 的 定义 和 组 件 定义 。 

。 创建 一 个 Handler 文 件 ， 扩 展 自 
NamespaceHandlerSupport， 目 的 是 将 组 件 注册 
到 Spring 容器 。 

。 编写 Spring.handlers 和 Spring.schemas 文 件 。 


现在 我 们 束 按 照 上 面 的 步骤 带领 读者 一 步 步 地 
体验 目 定 义 标签 的 过 程 。 

1. 首先 我 们 创建 一 个 普通 的 POJO， 这 个 
POJO 没 有 任何 特别 之 处 ， 只 是 用 来 接收 配置 文 
件 。 


package test.customtag; 











public class User ( 
private String userName; 
private String email; 





// 省 略 sSet/get 方 法 
} 





2. 定义 一 个 XSD 文件 摘 述 组 件 内 容 。 


<?xml version="1.0" encoding="UTF-8"?> 

«schema xmlns="http://www.w3.org/2001/XMLSchema" 
targetNamespace="http://www. lexueba.com/schema/user" 
xmlns:tnsz"http://www.lexueba.com/schema/user" 
elementFormDefault="qualified"> 


«element name="user'"> 
<complexType> 
<attribute name="id" type="string"/> 
«attribute name="userName" type="string"/> 
«attribute name="email" type="string"/> 
</complexType> 
</element> 
</schema> 





在 上 和 面 的 XSD 文 件 中 描述 了 一 个 新 的 
targetNamespace， 并 在 这 个 空间 中 定义 了 一 个 name 
为 user 的 element，user 有 3 个 属性 id、userName 和 
email， 其 中 email 的 类 型 为 string。 这 3 个 类 主要 用 于 
验证 Spring 配置 文件 中 目 定 义 格 式 。XSD 文 件 是 
XML DTD 的 符 代 者 ， 使 用 XML Schema 语言 进行 编 
写 ， 这 里 对 XSD Schema 不 做 太 多 解释 ， 有 兴趣 的 
读者 可 以 参考 相关 的 资料 。 


3. 创建 一 个 文件 ， 实 现 BeanDefinitionParser 接 
口 ， 用 来 解析 XSD 文 件 中 的 定义 和 组 件 定 义 。 














package test.customtag; 

Import org.Springframework.beans.factory.support.BeanDefinition 
Builder; 

import org.Springframework.beans.factory.xml.AbstractSingleBean 


DefinitionParser; 
import org.Springframework.util.StringUtils; 
import org.w3c.dom.Element; 


public class UserBeanDefinitionParser extends AbstractSingleBe 
anDefinitionParser ( 
//Element 对 应 的 类 
protected Class getBeanClass(Element element) { 
return User.class; 





} 
// 从 element 中 解析 并 提取 对 应 的 元 素 
protected void doParse(Element element, BeanDefinitionBuild 
er bean) ( 
String userName - element.getAttribute("userName"); 
String email - element.getAttribute("email"); 
// 将 提取 的 数据 放 入 到 BeanDefinitionBuilder 中 ， 待 到 完成 所 
有 bean 的 解析 后 统一 注册 到 beanFactory 中 
if (StringUtils.hasText(userName)) { 
bean.addPropertyValue("userName", userName); 











} 
if (StringUtils.hasText(email)) { 
bean.addPropertyValue("email", email); 





4. 创建 一 个 Handler 文 件 ， 扩 展 目 
NamespaceHandlerSupport， 目 的 是 将 组 件 注 册 到 
Spring 748 . 





package test.customtag; 


import org.Springframework.beans.factory.xml.NamespaceHandlerSu 
pport; 


public class MyNamespaceHandler extends NamespaceHandlerSupport 
{ 
public void init() { 
registerBeanDefinitionParser("user", new UserBeanD 
efinitionParser()); 


} 

以 上 代码 很 人 简单， 无非 是 当 人 过 到 目 定 义 标签 
<user:aaa 这 样 类 似 于 以 user 开 头 的 元 妙 ， 束 会 把 这 
个 元 素 扔 给 对 应 的 UserBeanDefinitionParser 去 解 
析 。 


5. 编写 Spring.handlers 和 Spring.schemas 文 件 ， 
默认 位 置 是 在 工程 的 /META-INE/ 文 件 夹 下 ， 当 
然 ， 你 可 以 通过 Spring 的 扩展 或 者 修改 源码 的 方式 
改变 路 径 。 








e Spring.handlers. 


http\://www. lexueba.com/schema/user=test.customtag.MyNamespaceH 
andler 


e Spring.schemas. 


http\://www. lexueba.com/schema/user . xSd=META-INF/Spring-test.xsd 
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Spring.handlers 和 Spring.schemas 中 去 找 对 应 的 


handler 和 XSD， 默 认 位 置 是 /META-INF/ 下 ， 进 而 
有 找到 对 应 的 handler 以 及 解析 元 素 的 Parser， 从 而 
完成 了 整个 目 定 义 元 素 的 解析 ， 也 就 是 说 目 定义 与 
Spring 中 默认 的 标准 配置 不 同 在 于 Spring 将 目 定 义 
标签 解析 的 工作 委托 给 了 用 户 去 实现 。 


6. 创建 测试 配置 文件 ， 在 配置 文件 中 引入 对 
应 的 命名 空间 以 及 XSD 后 ， 便 可 以 直接 使 用 目 定 义 
标签 了 。 














<beans xmlns="http://www.Springframework.org/schema/beans" 


xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:myname-z"http://www.lexueba.com/schema/user" 


xsi:schemaLocation-z"http://www.Springframework.org/sche 
ma/beans http://www. Springframework.org/schema/beans/Spring-be 
ans-2.0.xsd 

http://www.lexueba.com/schema/user http://www.lexueba.co 
m/schema/user.xsd 


Ws 
<myname:user id="testbean" userName="aaa" email="bbb"/> 


</beans> 





7. 测试 。 





public static void main(String[] args) { 

ApplicationContext bf - new ClassPathXmlApplicationCon 
text ("test/customtag/ test.xml"); 

User user=(User) bf.getBean("testbean"); 


System.out.printin(user.getUserName()+","+user.getEmai 


10); 
j 


不 出 意外 的 话 ， 你 应 该 看 到 了 我 们 期 每 的 结 
东 ， 控 制 合 上 打印 出 了 : 


在 上 面 的 例子 中 ， 我 们 实现 了 通过 目 定 义 标 签 
实现 了 通过 属性 的 方式 将 user 类 型 的 Bean 赋 值 ， 在 
Spring 中 目 定 义 标 签 非常 音 用 ， 例 如 我 们 熟知 的 事 


务 标签 : tx(<tx:annotation-driven>) . 
42 目 定 义 标签 解析 


本 解 了 目 定 义 标 签 的 使 用 后 ， 我 们 市 着 强烈 的 
好 奇 心 来 探 完 一 下 目 定 义 标签 的 解析 过 程 。 














public BeanDefinition parseCustomElement(Element ele) { 
return parseCustomElement 


(ele, null); 
} 


//containingBd 为 父 类 bean， 对 顶层 元 素 的 解析 应 设置 为 null 
public BeanDefinition parseCustomElement(Element ele, BeanDefin 
ition containingBd) { 

// 获 取 对 应 的 命名 空间 

String namespaceUri = getNamespaceURI 








(ele); 

// 根 据 命 名 空间 找到 对 应 的 NamespaceHandler 

NamespaceHandler handler = this.readerContext.getNames 
paceHandlerResolver 


(). resolve 


(namespaceUri); 
if (handler -- null) ( 
error("Unable to locate Spring NamespaceHandler fo 
r XML schema namespace [" + namespaceUri + "]", ele); 
return null; 


} 
// 调 用 自 定义 的 NamespaceHandler 进 行 解析 
return handler.parse 








(ele, new ParserContext(this.readerContext, this, containingBd) 











相信 了 解 了 目 定义 标签 的 使 用 方法 后 ， 或 多 或 
少 会 对 目 定义 标签 的 实现 过 程 有 一 个 目 己 的 想法 。 
其 实 思 路 非 第 的 人 简单， 无 非 是 根据 对 应 的 bean 获 取 
对 应 的 命名 空间 ， 根 据 命 名 空间 解析 对 应 的 处 理 
aa» JAJA AR AD Be A BR ASE TT ENT A xe 








有 些 事情 说 起 来 简单 做 起 来 难 ， 我 们 先 看 看 如 何 获 
取 命 名 空间 吧 ，。 


4.2.1 ”获取 标签 的 命名 空间 


标签 的 解析 是 从 命名 空间 的 提起 开始 的 ， 无 论 


是 区 分 Spring 中 默认 标 和 位 和 目 定义 标签 还 是 区 分 上 自 
定义 标签 中 不 同 标签 的 处 理 器 都 是 以 标签 所 提供 的 

命名 空间 为 基础 鸭 ， 而 至 于 如 何 提取 对 应 元 系 的 命 
£m s 间 其 实 并 不 需要 我 们 杀 目 去 实现 ， 在 
org.w3c.dom.Node 中 已 经 提供 了 方法 供 我 们 直接 调 
用 : 








public String getNamespaceURI(Node node) { 
return node.getNamespaceURI(); 


j 


4.2.2 ”提取 目 定 义 标 签 处 理 妖 


有 了 命名 空间 ， 束 可 以 进行 NamespaceHandler 
的 提取 了 了， 继续 之 前 的 parseCustomElement 函 数 的 
跟踪 ， 分 析 NamespaceHandler handler = 
this.readerContext.getNamespaceHandlerResolver(). 
resolve(namespaceUri), 7EreaderContext#J 4a 4^ BJ Ih] 
候 其 属性 namespaceHandlerResolver 已 经 被 初始 化 为 
了 DefaultNamespaceHandlerResolver 的 实例 ， 所 
以 ， 这 里 调用 的 resolve 方 法 其 实 调用 的 是 
DefaultNamespaceHandlerResolver 类 中 的 方法 。 我 
们 进入 DefaultNamespaceHandlerResolver 的 resolve 方 
法 进行 查看 。 





DefaultNamespaceHandlerResolver.java 





public NamespaceHandler resolve(String namespaceUri) { 

















// 获 取 所 有 已 经 配置 的 handler 映 射 
Map<String, Object> handlerMappings = getHandlerMappin 


// 根 据 命 名 空间 找到 对 应 的 信息 
Object handlerOrClassName = handlerMappings.get(namesp 
aceUri); 
if (handlerOrClassName == null) { 
return null; 
jelse if (handlerOrClassName instanceof NamespaceHandl 





er) ( 
// 已 经 做 过 解析 的 情况 ， 直 接 从 绥 存 读 取 


return (NamespaceHandler) handlerOrClassName; 








yelse ( 
// 没 有 做 过 解析 ， 则 返回 的 是 类 路 径 
String className = (String) handlerOrClassName; 
try { 
// 使 用 反射 将 类 路 径 转化 为 类 
Class<?> handlerClass = ClassUtils.forName(cla 
ssName, this.classLoader); 
if (!NamespaceHandler.class.isAssignableFrom(h 
andlerClass)) { 
throw new FatalBeanException("Class [" * c 
lassName + "] for 
namespace [" + namespaceUri + 
"] does not implement the [" + Nam 
espaceHandler.class. 
getName() + "] interface"); 


// 初 始 化 类 
NamespaceHandler namespaceHandler = (Namespace 
Handler) BeanUtils. 
instantiateClass(handlerClass); 
// 调 用 自 定义 的 NamespaceHandler 的 初始 化 方法 
namespaceHandler.init(); 
// 记 录 在 缓存 
handlerMappings.put(namespaceUri, namespaceHan 





I 





dler); 
return namespaceHandler; 
jcatch (ClassNotFoundException ex) { 
throw new FatalBeanException("NamespaceHandler 
class [" + className + "] for namespace [" + 
namespaceUri + "] not found", ex); 


}catch (LinkageError err) { 
throw new FatalBeanException("Invalid Namespac 
eHandler class [" + 
className + "] for namespace [" + 
namespaceUri + "]: problem with handle 
r class file or dependent class", err); 


j 
3 





上 面 的 函数 清晰 地 曾 述 了 解析 目 定 义 
NamespaceHandler 的 过 程 ， 通 过 之 前 的 示例 程序 我 
们 了 解 到 如 果 要 使 用 目 定义 标签 ， 那 么 其 中 一 项 必 





不 可 少 的 操作 就 是 在 Spring.handlers 文 件 中 配置 命 

名 空间 与 命名 空间 处 理 器 的 映射 关系 。 只 有 这 xit. 
Spring 才能 根据 映射 关系 找到 匹配 的 处 理 器 ， 而 寻 
找 匹 配 的 处 理 器 就 是 在 上 面 函 数 中 实现 的 ， 当 获取 
到 自 定义 的 NamespaceHandler 之 后 就 可 以 进行 处 理 
器 初始 化 并 解析 了 。 我 们 不 妨 再 次 回忆 一 下 示例 中 
对 于 命名 空间 处 理 器 的 内 容 : 








public class MyNamespaceHandler extends NamespaceHandlerSupport 


public void init() { 
registerBeanDefinitionParser("user", new UserBeanD 
efinitionParser()); 


j 
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namespaceHandler.init()2:3t 1T H xe X. Bean- 


DefinitionParser 的 注册 。 在 这 里 ， 你 可 以 注册 多 个 
标签 解析 右 ， 当 前 示例 中 只 有 支持 <myname:user 的 
写法 ， 你 也 可 以 在 这 里 注册 多 个 解析 器 ， 如 
<myname:A、<myname:B 等 ， 使 得 myname 的 命名 


空间 中 可 以 文 持 多 种 标 釜 解 析 。 


注册 后 ， 命 名 空间 处 理 占 束 可 以 根据 标签 的 不 
同 来 调用 不 同 的 解析 器 进行 解析 。 那 么 ， 根 据 上 面 
的 函数 与 之 前 介绍 过 的 例子 ， 我 们 基本 上 可 以 推断 
getHandlerMappings[) = Z I) He Sb xe: DEAN 
Ed ME 并 将 配置 文件 缓存 在 map 


private Map<String, Object» getHandlerMappings() { 
// 如 果 没 有 被 缓存 则 开始 进行 缓存 
if (this.handlerMappings -- null) ( 
synchronized (this) { 
if (this.handlerMappings == null) { 
try { 
//this.handlerMappingsLocation 在 构造 函数 
中 已 经 被 初始 化 为 :META- INF/ Spring.handlers 
Properties mappings = 
PropertiesLoaderUtils.loadAllP 








roperties (this. 
handlerMappingsLocation, this.classLoader); 
if (logger.isDebugEnabled()) { 
logger .debug( "Loaded NamespaceHand 
ler mappings: " + mappings); 


Map<String, Object> handlerMappings = 
new ConcurrentHashMap< String, Object>(); 
// 将 Properties 格 式 文件 合并 到 Map 格 式 的 hand1 





erMappings 中 

CollectionUtils.mergePropertiesIntoMap 
(mappings, handlerMappings); 

this.handlerMappings - handlerMappings 


} 
catch (IOException ex) { 
throw new IllegalStateException( 


"Unable to load NamespaceHandl 
er mappings from 


location [" + this.handlerMappingsLocation + "]", ex); 


J 
j 


return this.handlerMappings; 





同 我 们 想象 的 一 样 ， 借 助 了 工具 类 
PropertiesLoaderUtils 对 属性 
handlerMappingsLocation 进 行 了 配置 文件 的 读 取 ， 
handlerMappingsLocation 被 默认 初始 化 为 “META- 
INF/Spring.handlers” . 


4.2.3 ”标签 解析 


‘El SANT A A Re oy iT oa, Spring 
可 以 将 解析 工作 委托 给 目 定 义 解 析 器 去 解 机 了 。 在 
Spring 中 的 代码 为 : 


return handler.parse(ele, new ParserContext(this.readerContext, 
this, containingBd)) 


以 之 前 提 到 的 示例 进行 分 析 ， 此 时 的 handler 已 


经 被 实例 化 成 我 们 目 定 义 的 MyNamespace- Handler 

了 ， 而 MyNamespaceHandler 也 已 经 完成 了 初始 化 的 
工作 ， 但 是 在 我 们 实现 的 自 定 义 命名 空间 处 理 器 中 

中 的 实现 ， 查 看 父 类 NamespaceHandlerSupport 中 的 

parse 方 法 。 





NamespaceHandlerSupport.java 


public BeanDefinition parse(Element element, ParserContext pars 
erContext) { 
// 寻 找 解析 器 并 进行 解析 操作 


return findParserForElement 








(element, parserContext).parse 


(element, parserContext); 
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而 调用 解析 器 中 的 parse 方 法 ， 那 么 结合 示例 来 讲 ， 
其 实 束 是 首先 获取 在 MyNameSpaceHandler 类 中 的 
init 方 法 中 注册 的 对 应 的 UserBean- DefinitionParser 
实例 ， 并 调用 其 parse 方 法 进行 进一步 解析 。 











private BeanDefinitionParser findParserForElement(Element eleme 
nt, ParserContext parser 
Context) { 
// 获 取 元 素 名 称 ， 也 就 是 <myname :user 中 的 user, 若 在 示例 中 ， 此 时 1o 
calName 为 user 
String localName = parserContext.getDelegate().getLoca 
lName(element); 








// 根 据 user 找 到 对 应 的 解析 器 ， 也 就 是 在 
//registerBeanDefinitionParser("user", new UserBeanDefinitionPa 
rser()); 

// 注 册 的 解析 器 


BeanDefinitionParser parser = this.parsers.get(localNa 








me); 
if (parser -- null) ( 
parserContext.getReaderContext().fatal( 
"Cannot locate BeanDefinitionParser for el 
ement [" + localName + "|", element); 


j 


return parser; 





而 对 于 parse 方 法 的 处 理 : 





public final BeanDefinition parse(Element element, ParserContex 
t parserContext) ( 
AbstractBeanDefinition definition - parseInternal 


(element, parserContext); 
if (definition != null && !parserContext.isNested()) (1 
try { 
String id - resolveld(element, definition, par 
serContext); 
if (!StringUtils.hasText(id)) { 
parserContext.getReaderContext().error( 


"Id is required for element '" + p 
arserContext. getDelegate(). getLocalName(element) 
+ "' when used as a top-le 


vel tag", element); 

} 

String[] aliases = new String[0]; 

String name = element.getAttribute(NAME_ATTRIB 
UTE); 

if (StringUtils.hasLength(name)) { 

aliases = StringUtils.trimArrayElements(St 

ringUtils.commaDelimitedList ToStringArray(name) ); 

} 

// 将 AbstractBeanDefinition 转 换 为 BeanDefinitionHo 
lder 并 注册 

BeanDefinitionHolder holder = new BeanDefiniti 


onHolder(definition, id, 
aliases); 
registerBeanDefinition(holder, parserContext.g 
etRegistry()); 
if (shouldFireEvents()) ( 
// 需 要 通知 监听 器 则 进行 处 理 
BeanComponentDefinition componentDefinitio 
n - new BeanComponentDefinition 
(holder); 























postProcessComponentDefinition(componentDe 
finition); 
parserContext.registerComponent(componentD 


i 


efinition); 


catch (BeanDefinitionStoreException ex) { 
parserContext.getReaderContext().error(ex.getM 
essage(), element); 
return null; 


j 


return definition; 








虽说 是 对 目 定 义 配 置 文件 的 解析 ， 但 是 ， 我 们 
可 以 看 到 ， 在 这 个 函数 中 大 部 分 的 代码 是 用 来 处 理 
将 解析 后 的 AbstractBeanDefinition 转 化 为 
BeanDefinitionHolder 并 注册 的 功能 ， 而 真正 去 做 解 
析 的 事情 委托 给 了 函数 parseInternal， 正 是 这 人 句 代 码 
调用 了 我 们 目 定 义 的 解析 函数 。 








在 parseInternal 中 并 不 是 直接 调用 目 定义 的 
doParse 冰 数 ， 而 是 进行 了 一 系列 的 数据 准备 ， 包 括 
对 beanClass、scope、lazyInit 等 属性 的 准备 。 


protected final AbstractBeanDefinition parselnternal(Element el 
ement, ParserContext 
parserContext) ( 

BeanDefinitionBuilder builder - BeanDefinitionBuilder. 
genericBeanDefinition(); 

String parentName - getParentName(element); 

if (parentName != null) { 

builder .getRawBeanDefinition().setParentName(paren 

tName ) ; 


} 
// 获 取 自 定义 标签 中 的 class， 此 时 会 调用 自 定义 解析 器 如 UserBeanDefinitio 
nParser 中 的 getBeanClass 方 法 
Class<?> beanClass = getBeanClass(element); 
if (beanClass != null) { 


builder.getRawBeanDefinition().setBeanClass(beanCl 














ass); 


j 


else ( 
// 若 子 类 没有 重 写 getBeanClass 方 法 则 尝试 检查 子 类 是 否 重 写 getBeanC 
lassName 方 法 




















String beanClassName = getBeanClassName(element); 
if (beanClassName !- null) { 
builder.getRawBeanDefinition().setBeanClassNam 
e(beanClassName); 
y 
} 
builder.getRawBeanDefinition().setSource(parserContext 
.extractSource(element)); 
if (parserContext.isNested()) ( 
// 若 存在 父 类 则 使 用 父 类 的 scope 属 性 
builder.setScope(parserContext.getContainingBeanDe 
finition().getScope()); 
} 
if (parserContext.isDefaultLazyInit()) { 
// Default-lazy-init applies to custom bean defini 
tions as well. 
// 配 置 延迟 加 载 
builder.setLazyInit(true); 




















} 
// 调 用 子 类 重 写 的 doPar se 方法 进行 解析 
doParse 





(element, parserContext, builder); 
return builder.getBeanDefinition(); 


Jj 


protected void doParse(Element element, ParserContext parserCon 
text, BeanDefinition 
Builder builder) { 

doParse 


(element, builder); 





回顾 一 下 全 部 的 和 目 定义 标签 处 理 过 程 ， 虽 然 在 
实例 中 我 们 定义 UserBeanDefinitionParser， 但 是 在 








其 中 我 们 只 是 做 了 与 自己 业务 逻辑 相关 的 部 分 。 不 
过 我 们 没 做 但 是 并 不 代表 没有 ， 在 这 个 处 理 过 程 中 
同样 也 是 按照 Spring 中 默认 标签 的 处 理 方 式 进 行 ， 
包括 创建 BeanDefinition 以 及 进行 相应 默认 属性 的 设 
置 ， 对 于 这 些 工 作 Spring 都 默默 地 帮 我 们 实现 了 ， 
只 是 骏 露 出 一 些 接 口 来 供用 户 实 现 个 性 化 的 业务 。 
通过 对 本 章 的 了 解 ， 相 信 读 者 对 Spring 中 上 自 定 义 标 
签 的 使 用 以 及 在 解析 自 定 义 标签 过 程 中 Spring 为 我 
们 做 了 哪些 工作 会 有 一 个 全 面 的 了 解 。 到 此 为 止 我 
们 已 经 完成 了 Spring 中 全 部 的 解析 工作 ， 也 就 是 说 
到 现在 为 止 我 们 已 经 理解 了 Spring 将 bean 从 配置 文 
件 到 加 载 到 内 存 中 的 全 过 程 ， 而 接 下 来 的 任务 便 是 
如 何 使 用 这 些 bean， 下 一 章 将 介绍 bean 的 加 载 。 














第 5 章 ”bean 的 加 载 


经 过 前 面 的 分 析 ， 我 们 终于 结束 了 对 XML 配置 
文件 的 解析 ， 接 下 来 将 会 面临 更 大 的 挑战 ， 束 是 对 
bean 加 载 的 探索 。bean 加 载 的 功能 实现 远 比 bean 的 
解析 要 复杂 得 多 ， 同 样 ， 我 们 还 是 以 本 书 开篇 的 示 
例 为 基础 ， 对 于 加 载 bean 的 功能 ， 在 Spring 中 的 调 
用 方式 为 : 


MyTestBean bean=(MyTestBean) bf.getBean("myTestBean") 


这 人 句 代 人 码 实 现 了 什么 样 的 功能 呢 ? 我 们 可 以 先 
快速 体验 一 下 Spring 中 代码 是 如 何 实现 的 。 








public Object getBean(String name) throws BeansException { 
return doGetBean 


(name, null, null, false); 


protected «T» T doGetBean( 
final String name, final Class<T> requiredType, fi 
nal Object[] args, 
boolean typeCheckOnly) throws BeansException { 
// 提 取 对 应 的 beanName 
final String beanName = transformedBeanName (name); 
Object bean; 


ks 





* 检查 缓存 中 或 者 实例 工厂 中 是 否 有 对 应 的 实例 

* 为 什么 首先 会 使 用 这 段 代码 呢 ， 

* 因为 在 创建 单 例 bean 的 时 候 会 存在 依赖 注入 的 情况 ， 而 在 创建 依赖 的 
时 候 为 了 避免 循环 依赖 ， 

* Spring 创建 bean 的 原则 是 不 等 bean 创 建 完 成 就 会 将 创建 bean 的 0bj 
ectFactory 提 早 曝光 

* 也 就 是 将 0bjectFactory 加 入 到 缓存 中 ， 一 旦 下 个 bean 创 建 时 候 需 
要 依赖 上 个 bean 则 直接 使 用 0bjectFactory 

*/ 

// 直 接 尝试 从 缓存 获取 或 者 singLletonFactories 中 的 0bjectFactory 















































中 获取 


Object sharedInstance = getSingleton 


(beanName); 
if (sharedInstance !- null && args == null) { 
if (logger.isDebugEnabled()) { 
if (isSingletonCurrentlyInCreation(beanName)) 

{ 

logger .debug("Returning eagerly cached ins 
tance of singleton bean '" + beanName + 

"' that is not fully initialized y 

et - a consequence of a circular reference"); 


} 
else ( 
logger.debug("Returning cached instance of 
Singleton bean '" + 
beanName + "'"); 
} 








} 
// 返 回 对 应 的 实例 ， 有 时 候 存 在 诸如 BeanFactory 的 情况 并 不 是 直接 返回 实例 本 身 而 
是 返回 指定 方法 返回 的 实例 

bean = getObjectForBeanInstance 

















(sharedInstance, name, beanName, null); 
jelse ( 
// 只 有 在 单 例 情况 才 会 尝试 解决 循环 依赖 ， 原 型 模式 情况 下 ， 如 果 存 


在 
//A 中 有 B 的 属性 ，B 中 有 A 的 属性 ， 那 么 当 依 赖 注入 的 时 候 ， 束 会 产 
生 当 A 还 未 创建 完 的 时 候 因 为 
// 对 于 B 的 创建 再 次 返回 创建 A， 造 成 循环 依赖 ， 也 就 是 下 面 的 情况 
//isPrototypeCurrentlyInCreation(beanName) Atrue 
if (isPrototypeCurrentlyInCreation(beanName)) { 
throw new BeanCurrentlyInCreationException(bea 












































nName ) ; 


BeanFactory parentBeanFactory = getParentBeanFacto 
ry(); 





// 如 果 beanDefinitionMap 中 也 就 是 在 所 有 已 经 加 载 的 类 中 不 包括 
beanName 则 尝试 从 
//parentBeanFactory 中 检测 
if (parentBeanFactory !- null && !containsBeanDefi 
nition(beanName)) { 
String nameToLookup - originalBeanName(name); 
// 递 归 到 BeanFactory 中 寻找 
if (args !- null) ( 
return (T) parentBeanFactory.getBean(nameT 





oLookup, args); 


else { 
return parentBeanFactory.getBean(nameToLoo 
kup, requiredType); 








} 

// 如 果 不 是 仅仅 做 类 型 检查 则 是 创建 bean， 这 里 要 进行 记录 

if (!typeCheckOnly) ( 
markBeanAsCreated(beanName ) ; 


j 


// 将 存储 XML 配置 文件 的 GernericBeanDefinition 转 换 为 RootB 
eanDefinition， 如 果 指 定 

//BeanName 是 子 Bean 的 话 同时 会 合并 父 类 的 相关 属性 

final RootBeanDefinition mbd = getMergedLocalBeanD 
efinition(beanName); 

checkMergedBeanDefinition(mbd, beanName, args); 























String[] dependsOn = mbd.getDependsOn(); 
// 若 存在 依赖 则 需要 递归 实例 化 依赖 的 bean 
if (dependsOn !- null) ( 
for (String dependsOnBean : dependsOn) { 
getBean(dependsOnBean); 
/ 1 BAER RGA FA 
registerDependentBean(dependsOnBean, beanN 











ame); 


Jj 


// 实 例 化 依赖 的 bean 后 便 可 以 实例 化 mbd 本 身 了 
//singleton 模 式 的 创建 
if (mbd.isSingleton()) { 





sharedInstance - getSingleton 


(beanName, new ObjectFactory<Object>() { 
public Object getObject() throws BeansExce 
ption { 
try { 
return createBean 


(beanName, mbd, args); 


catch (BeansException ex) { 
destroySingleton(beanName); 
throw ex; 


} 
J): 


bean - getObjectForBeanInstance 


(sharedInstance, name, beanName, mbd); 
jelse if (mbd.isPrototype()) ( 
//prototype 模 式 的 创建 (new) 
Object prototypeInstance = null; 
try { 
beforePrototypeCreation(beanName); 
prototypelnstance = createBean 





(beanName, mbd, args); 


finally ( 
afterPrototypeCreation(beanName); 


j 


bean - getObjectForBeanInstance 


(prototypelnstance, name, beanName, mbd); 
jelse ( 
// 指 定 的 scope 上 实例 化 bean 
String scopeName = mbd.getScope(); 
final Scope scope - this.scopes.get(scopeName) 





if (scope == null) { 
throw new IllegalStateException("No Scope 
registered for scope '" + scopeName + "'"); 
} 


try { 
Object scopedInstance = scope.get(beanName 


, new ObjectFactory<Object>() { 
public Object getObject() throws Beans 
Exception { 
beforePrototypeCreation(beanName); 


try { 
return createBean 


(beanName, mbd, args); 


} 
finally { 
afterPrototypeCreation(beanNam 
e); 
} 


} 
J): 


bean - getObjectForBeanInstance 
(scopedInstance, name, beanName, mbd); 


catch (IllegalStateException ex) { 
throw new BeanCreationException(beanName, 
"Scope '" + scopeName + "' is not 
active for the current thread; " + 
"consider defining a scoped proxy 
for this bean if you intend to refer to it from a singleton", 
ex); 


j 
j 


// 检 查 需 要 的 类 型 是 否 符 合 bean 的 实际 类 型 
if (requiredType !- null && bean != null && !requiredT 
ype.isAssignableFrom 
(bean.getClass())) { 
try { 
return getTypeConverter().convertIfNecessary(b 
ean, requiredType); 











catch (TypeMismatchException ex) ( 
if (logger.isDebugEnabled()) { 
logger.debug("Failed to convert bean '" + 
name + "' to required 
type [" * 
ClassUtils.getQualifiedName(requir 
edType) + "]", ex); 


} 
throw new BeanNotOfRequiredTypeException(name, 
requiredType, bean. 
getClass()); 
} 


return (T) bean; 








仅 从 代码 量 上 就 能 看 出 来 bean 的 加 载 经 历 了 一 


个 相当 复杂 的 过 程 ， 其 中 涉及 各 种 各 样 的 考虑 。 相 
信 读 者 细心 阅读 上 面 的 代码 ， 并 参照 部 分 代码 注 
释 ， 是 可 以 粗略 地 了 解 整个 Spring 加 载 bean 的 过 
程 。 对 于 加 载 过 程 中 所 涉及 的 步骤 大 致 如 下 。 





1. 转换 对 应 beanName 


或 许 很 多 人 不 理解 转换 对 应 beanName 是 什么 
意思 ， 传 入 的 参数 name 不 就 是 beanName 吗 ? 其 实 
不 是 ， 这 里 传 入 的 参数 可 能 是 别名 ， 也 可 能 是 
FactoryBean， 上 所 以 需要 进行 一 系列 的 解 机， 这 些 解 
析 内 容 包括 如 下 内 容 。 


e 去 除 FactoryBean 的 修饰 符 ， 也 束 是 如 果 
name="&aa"， 那 么 会 首先 去 除 & 而 使 
name= aa 。 

。 取 指定 alias 所 表示 的 最 终 beanName， 例 如 别名 A 
指 癌 名 称 为 B 的 bean 则 返回 B; 和 看 别 名 A 指 回 别 
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次 ， 后 续 再 获取 bean， 束 直接 从 单 例 缓存 中 获取 
了 。 当 然 这 里 也 只 是 答 斌 加载， 首先 答 试 从 绥 存 中 
加 载 ， 如 有 果 加 载 不 成 功 则 再 次 答 试 从 
singletonFactories 中 加 载 。 因 为 在 创建 单 例 bean 的 时 
候 会 存在 依赖 注入 的 情况 ， 而 在 创建 依赖 的 时 候 为 
了 避免 循环 依赖 ， 在 Spring 中 创建 bean 的 原则 是 不 
等 bean 创 建 完 成 就 会 将 创建 bean 的 ObjectFactory 提 
早 曝光 加 入 到 缓存 中 ， 一 旦 下 一 个 bean 创 建 时 候 需 
要 依赖 上 一 个 bean 则 直接 使 用 ObjectFactory (后 面 
章 市 会 对 循环 依赖 重点 讲解 〉。 








3. bean 的 实例 化 


如 果 从 缓存 中 得 到 了 bean 的 原始 状态 ， 则 需要 
对 bean 进 行 实例 化 。 这 里 有 必要 强调 一 下 ， 绥 存 中 
记录 的 只 是 最 原始 的 bean 状 态 ， 并 不 一 定 是 我 们 最 
终 想 要 的 bean。 举 个 例子 ， 假 如 我 们 需要 对 工矿 
bean 进 行 处 理 ， 那 么 这 里 得 到 的 其 实 是 工厂 bean 的 
初始 状态 ， 但 是 我 们 真正 需要 的 是 工厂 bean 中 定义 
的 factory-method 方 法 中 返回 的 bean， 而 











getObjectForBeanInstance 束 是 完成 这 个 工作 的 ， 后 
续 会 详细 讲解 。 


4， 原 型 模式 的 依赖 检 碍 





只 有 在 单 例 情况 下 才 会 答 试 解决 循环 依赖 ， 如 
果 存 在 A 中 有 B 的 属性 ，B 中 有 A 的 属性 ， 那 么 当 依 
赖 注入 的 时 候 ， 吏 会 产生 当 A 还 未 创建 完 的 时 候 因 
为 对 于 B 的 创建 再 次 返回 创建 A， 造 成 循环 依赖 ， 
也 残 是 情况 : 
isPrototypeCurrentlyInCreation(beanName) 判 断 true。 


5. 检测 parentBeanFactory 


从 代码 上 看 ， 如 来 缓存 没有 数据 的 话 卫 接 转 到 
ZRI ERWI, KENTA? 


可 能 读者 忽略 了 一 个 很 重要 的 判断 条 件 : 
parentBeanFactory !- null && !containsBean 
Definition (beanName), parentBeanFactory != null. 
parentBeanFactory RA 22, MAWE — HAE 
云 ， 这 个 没什么 说 的 ， 但 
是 !containsBeanDefinition(beanName) 就 比较 重要 
了 ， 它 是 在 检测 如 采 当 前 加 载 的 XML 配置 文件 中 不 
包含 beanName 所 对 应 的 配置 ， 束 只 能 到 











parentBeanFactory ŽA FS, AJGA RBA AY Ud 
用 getBean 方 法 。 


6. 将 存储 XML 配置 文件 的 GernericBeanDefinition 
转换 为 RootBeanDefinition 


因为 从 XML 配置 文件 中 恋 取 到 的 bean 信 息 是 存 
储 在 GernericBeanDefinition 中 的 ， 但 是 所 有 的 bean 
后 续 处 理 都 是 针对 于 RootBeanDefinition 的 ， 所 以 这 
里 需要 进行 一 个 转换 ， 转 换 的 同时 如 果 父 类 bean 不 
为 空 的 话 ， 则 会 一 并 合并 父 类 的 属性 。 


7. 寻找 依赖 


因为 bean 的 初始 化 过 程 中 很 可 能 会 用 到 某 些 属 
性 ， 而 茶 些 属性 很 可 能 是 动态 配置 的 ， 并 且 配 置 成 
依赖 于 其 他 的 bean， 那 么 这 个 时 候 束 有 必要 先 加 载 
依赖 的 bpean， 所 以 ， 在 Spring 的 加 载 顺 寻 中 ， 在 初 
始 化 某 一 个 bean 的 时 候 首 先 会 初始 化 这 个 bean 所 对 
应 的 依赖 。 





8. 针对 不 同 的 scope 进 行 bean 的 创建 


我 们 都 知道 ， 在 Spring 中 存在 着 不 同 的 scope， 
其 中 默认 的 是 singleton， 但 是 还 有 些 其 他 的 配置 诸 








如 prototype、request 之 类 的 。 在 这 个 步骤 中 ， 
Spring 会 根据 不 同 的 配置 进行 不 同 的 初始 化 策略 。 


9. 类 型 转换 


程序 到 这 里 返回 bean 后 已 经 基本 结束 了， 通常 
对 该 方法 的 调用 参数 requiredType 是 为 空 的 ， 但 是 
可 能 会 存在 这 样 的 情况 ， 返 回 的 bean 其 实 是 个 
String， 但 是 requiredType 却 传 入 Integer 类 型 ， 那 么 
这 时 候 本 步 又 就 会 起 作用 了 ， 它 的 功能 是 将 返回 的 
bean 转 换 为 requiredType 所 指定 的 类 型 。 当 然 ， 
String 转 换 为 Integer 是 最 简单 的 一 种 转换 ， 在 Spring 
中 提供 了 各 种 各 样 的 转换 器 ， 用 户 也 可 以 自己 扩展 
转换 器 来 满足 需求 。 


经 过 上 面 的 步骤 后 bean 的 加 载 就 结束 了 ， 这 个 
时 候 就 可 以 返回 我 们 所 需要 的 bean 了， 图 5-1 和 直观 地 
反映 了 整个 过 程 。 其 中 最 重要 的 束 是 步 又 8， 人 针对 
不 同 的 scope 进 行 bean 的 创建 ， 你 会 看 到 各 种 和 常用 的 
Spring 特性 在 这 里 的 实现 。 


在 细 化 分 析 各 个 步骤 提供 的 功能 前 ， 我 们 有 必 
要 先 了 解 下 FactoryBean 的 用 法 。 








(9 Property:«Java ClasssAbstractBeanFactory 










© Property5:«Java Interface» TypeConverter 


1: doGetBean(String, Class<T>, Object[], boolean) | 






1.1: getSingleton ; gear 


| bean 


2: sharedInstance 








EE sharedInstance != nu 


1: getObjectForBea 


&& args == null] 
nce(Object, String, String, RootBeanDefinition) | 


| 


返回 对 应 的 实例 ， 有 时 候 存 在 诸如 BeanFactory 的 










AR 一 一 一 情况 并 不 是 直接 返回 实例 本 身 而 是 返回 指定 方法 
IESE! 















[parentBeanFactory != 






| && !containsBeanDefinition(beanName)] 









如 果 当 前 不 存在 beanName， 调用 方法 
parentBeanFactory,getBean 去 光 类 工厂 中 
寻找 ， LAI Rm 









| 
| 
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RootBeanDeFinition ， 如 果 指 定 BeanName 是 子 Bean 的 话 
同时 会 合并 人 改 类 的 相关 属性 Text 



















opt 








[如 时 指定 的 需求 尖 型 不 为 定 珊 要 进行 类 型 转换 百 则 直 扩 3 晶 制 转 欣 ] 


1 etTyp eConverter() 


4-2: getTypeConverter 
3: convertifNecessary(value,requireType) 


4: object 了 


| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 
| 








图 5-1 ”bean 的 获取 过 程 
5.1 FactoryBean 的 使 用 


一 般 情 况 下 ，Spring 通 过 反射 机 制 利用 bean 的 
class 属 性 指定 实现 类 来 实例 化 bean 。 在 茶 些 情况 
下 ， 实 例 化 bean 过 程 比 较 复 全， 如 有 果 按 照 传统 的 方 
式 ， 则 需要 在 <bean> 中 提供 大 量 的 配置 信息 ， 配 置 
方式 的 灵活 性 是 党 限 的 ， 这 时 采用 编码 的 方式 可 能 
会 得 到 一 个 简单 的 方案 。 Spring 为 此 提供 了 s 
org.Springframework.bean.factory.FactoryBeanff] T) - 
a ， 用 户 可 以 通过 实现 该 接口 定制 实例 化 bean 
的 逻辑 。 


FactoryBean 接 口 对 于 Spring 框架 来 说 占有 重要 
的 地 位 ，Spring 上 自身 就 提供 了 70 多 个 FactoryBean 的 
实现 。 它 们 隐藏 了 实例 化 一 些 复杂 bean 的 细节 ， 给 
上 层 应 用 带 来 了 便利 。 从 Spring 3.0 开始 ， 
FactoryBean 开 始 文 持 泛 型 ， 即 接口 声明 改 为 
FactoryBean<T> 的 形式 : 




















package org.Springframework.beans.factory; 
public interface FactoryBean<T> { 
T getObject() throws Exception; 
Class<?> getObjectType(); 
boolean isSingleton(); 


j 


————————— HM! 
在 该 接口 中 还 定义 了 以 下 3 个 方法 。 





e T getObject(): 返回 由 FactoryBean 创 建 的 bean 实 
例 ， 如 果 isSingleton() 返 回 true， 则 该 实例 会 放 到 
Spring ts rp E Sc p Ze TEL HH . 

e boolean isSingleton(): 返回 由 FactoryBean 创 建 的 
bean 实 例 的 作用 域 是 singleton 还 是 prototype。 

e Class<T> getObjectType(): 返回 FactoryBean 创 | 
建 的 bean 类 型 。 


当 配 置 文 件 中 <bean> 的 class 属 性 配置 的 实现 类 
是 FactoryBean 时 ， 通 过 getBean0) 方 法 返回 的 不 是 
FactoryBean 本 里 ， 而 是 FactoryBean#getObject() 方 法 
所 返回 的 对 象 ， 相 当 于 FactoryBean#getObject() 代 理 
了 getBean0) 方 法 。 例 如 : 如 果 使 用 传统 方式 配置 下 
面 Car 的 <bean> 时 ，Car 的 每 个 属性 分 别 对 应 一 个 
«property? JR Es c 











public class Car { 
private int maxSpeed ; 
private String brand ; 
private double price ; 





//get/set 方 法 





如 果 用 FactoryBean 的 方式 实现 就 会 灵活 一 些 ， 


B SEE ES EF IS 73 UR PE Car lh PEE 
属性 指定 配置 值 ; 


public class CarFactoryBean implements FactoryBean<Car> 


private String carInfo ; 

public Car getObject () throws Exception { 
Car car = new Car () ; 
String [] infos = cariInfo .split ( '"," ) ; 
car.setBrand ( infos [ 0 ]) ; 
car.setMaxSpeed ( Integer. valueOf ( infos [ 1 ])) ; 
car.setPrice ( Double. valueOf ( infos [ 2 ])) ; 
return car; 


} 
public Class<Car> getObjectType () 
return Car. class ; 


public boolean isSingleton () 
return false ; 


public String getCarInfo () 
return this . carInfo ; 


j 


// TRSOXES A] RISE LIS TEE f Je 
public void setCarInfo ( String carInfo ) 
this . carInfo = carInfo; 








j 





有 了 这 个 CarFactoryBean 后 ， 就 可 以 在 配置 文 
件 中 使 用 下 面 这 种 目 定 义 的 配置 方式 配置 Car Bean 


«bean id="car" class="com.test.factorybean.CarFactoryBean" carI 
nfo=" 超 级 跑车 , 400, 2000000"/> 





当 调 用 getBean("car") 时 ，Spring 通 过 反射 机 制 
发 现 CarFactoryBean 实 现 了 FactoryBean 的 接口 ， 这 
IN Spring as Wt Val H fe O 77 1X 
CarFactoryBean#getObjectO 方 法 返回 。 如 果 硕 望 获 
取 CarFactoryBean 的 实例 ， 则 需要 在 使 用 
getBean(beanName) 方法 时 在 beanName 前 显示 的 加 
上 "&" 有 前 级 ， 例 如 getBean("&car")。 


5.2” 绥 存 中 获取 早 例 bean 








介绍 过 FactoryBean 的 用 法 后 ， 我 们 束 可 以 了 解 
bean 加 载 的 过 程 了 。 前 面 已 经 提 到 过 ， 单 例 在 
Spring 的 同一 个 容器 内 只 会 被 创建 一 次 ， 后 续 再 获 
取 bean 直 接 从 单 例 绥 存 中 获取 ， 当 然 这 里 也 只 是 答 
试 加 载 ， 首 先 答 试 从 缓存 中 加 载 ， 然 后 再 次 符 试 答 
试 从 singletonFactories 中 加 载 。 因 为 在 创建 单 例 bean 
的 时 候 会 存在 依赖 注入 的 情况 ， 而 在 创建 依赖 的 时 
候 为 了 避免 循环 依赖 ，Spring 创 建 bean 的 原则 是 不 
等 bean 创 建 完 成 就 会 将 创建 bean 的 ObjectFactory 提 
早 曝 光 加 入 到 缓存 中 ， 一 旦 下 一 个 bean 创建 时 需要 
依赖 上 个 bean， 则 直接 使 用 ObjectFactory。 

















public Object getSingleton(String beanName) { 
// 参 数 true 设 置 标识 允许 早期 依赖 
return getSingleton 


(beanName, true); 


J 


protected Object getSingleton(String beanName, boolean allowEar 
lyReference) { 
/ SERIE t FETE EB 
Object singletonObject - this.singletonObjects.get(bea 
nName); 
if (singletonObject -- null) ( 
// 如 果 为 空 ， 则 锁定 全 局 变量 并 进行 处 理 
synchronized (this.singletonObjects) { 
// 如 果 此 bean 正 在 加 载 则 不 处 理 
singletonObject = this.earlySingletonObjects.g 





















































et (beanName); 
if (singletonObject -- null && allowEarlyRefer 


ence) { 








// 当 某 些 方法 需要 提前 初始 化 的 时 候 则 会 调用 addSingle 
tonFactory 方 法 将 对 应 的 
/V/objectFactory 初 始 化 策略 存储 在 singletonFacto 





ries 
ObjectFactory singletonFactory - this.sing 
letonFactories.get 
(beanName); 
if (singletonFactory !- null) { 
// 调 用 预先 设 定 的 get0bject 方 法 
singletonObject = singletonFactory.get 








Object(); 

// 记 录 在 缓存 中 ,，earlySingleton0bjects 和 si 
ngletonFactories 互 斥 

this.earlySingletonObjects.put(beanNam 
e, singletonObject); 

this.singletonFactories.remove(beanNam 
e); 


} 
} 
return (singletonObject != NULL OBJECT ? singletonObje 
ct : null); 
} 





这 个 方法 因为 涉及 循环 依赖 的 检测 ， 以 及 涉 


很 多 变量 的 记录 存 取 ， 上 所 以 让 很 多 读者 措 不 着 头 
脑 。 这 个 方法 首先 党 试 从 singletonObjects 里 面 获 取 
实例 ， 如 果 获 取 不 到 再 从 earlySingleton- Objects 里 
IRA, WRAPS, BAM 
singletonFactories € rft] 3k Bt beanName» v A) 
ObjectFactory， 然 后 调用 这 个 ObjectFactory 的 
getObject 来 创建 bean， 并 放 到 earlySingleton- Objects 
里 面 去 ， 并 且 从 singletonFacotories 里 面 remove 掉 这 
个 ObjectFactory， 而 对 于 后 续 的 所 有 内 存 操作 都 只 
为 了 循环 依赖 检测 时 候 使 用 ， 也 就 是 在 
allowEarlyReference 为 true 的 情况 下 才 会 使 用 。 


这 里 涉及 用 于 存储 bean 的 不 同 的 map， 可 能 让 
读者 感到 月 溃 ， 简 单 解释 如 下 。 


e singletonObjects: 用 于 保存 BeanName 和 创建 
bean 实 例 之 间 的 关系 ，bean name --> bean 
instance. 

singletonFactories: 用 于 保存 BeanName 和 创建 
bean 的 工厂 之 间 的 天 系 ，bean name --> 
ObjectFactory。 

earlySingletonObjects: 也 是 保存 BeanName 和 创 
建 bean 实 例 之 间 的 关系 ， 与 singletonObjects 的 不 
同 之 处 在 于 ， 当 一 个 单 例 bean 被 放 到 这 里 面 
后 ， 那 么 当 bean 还 在 创建 过 程 中 ， 束 可 以 通过 
getBean 方 法 获取 到 了 ， 其 目的 是 用 来 检测 循环 

















引用 。 
e registeredSingletons: 用 来 保存 当前 所 有 已 注册 
的 bean 。 


5.3 ”从 bean 的 实例 中 获取 对 和 象 


在 getBean 方 法 中 ，getObjectForBeanInstance 是 
个 高 频率 使 用 的 方法 ， 无 论 是 从 缓存 中 获得 bean 还 
是 根据 不 同 的 scope 寅 上 略 加 载 bean。 忌 之， 我 们 得 到 
bean 的 实例 后 要 做 的 第 一 步 就 是 调用 这 个 方法 来 检 
测 一 下 正确 性 ， 其 实 就 是 用 于 检测 当前 bean 是 个 是 
FactoryBean 类 型 的 beaan， 如 果 是 ， 那 么 需要 调用 该 
bean 对 应 的 FactoryBean 实 例 中 的 getObjectO 作 为 返 
ll B e 


无 论 是 从 缓存 中 获取 到 的 bean 还 是 通过 不 同 的 
scope 寅 略 加 载 的 bean 都 只 是 最 原始 的 bean 状 态 ， 并 
不 一 定 是 我 们 最 终 想 要 的 bean。 举 个 例子 ， 假 如 我 
们 需要 对 工厂 bean 进 行 处 理 ， 那 么 这 里 得 到 的 其 实 
是 工厂 bean 的 初始 状态 ， 但 是 我 们 真正 需要 的 是 工 
三 bean 中 定义 的 factory-method 方 法 中 返回 的 bean， 
而 getObjectForBeanInstance 方 法 就 是 完成 这 个 工作 
I 


protected Object getObjectForBeanInstance( 
Object beanInstance, String name, String beanName, 


























RootBeanDefinition mbd) ( 





// 如 果 指 定 的 name 是 工厂 相关 ( 以 & 为 前 级) 有 旦 beanInstance 叉 不 是 Fac 
toryBean 类 型 则 验证 不 通过 
if (BeanFactoryUtils.isFactoryDereference(name) && !(b 
eanInstance instanceof FactoryBean)) { 
throw new BeanIsNotAFactoryException(transformedBe 
anName(name), beanInstance. 
getClass()); 


j 


// 现 在 我 们 有 了 个 bean 的 实例 ， 这 个 实例 可 能 会 是 正常 的 bean 或 者 是 Fac 
toryBean 

// 如 果 是 FactoryBean 我 们 使 用 它 创建 实例 ， 但 是 如 果 用 户 想 要 直接 获取 

厂 实例 而 不 是 工厂 的 

//get0bject 方 法 对 应 的 实例 那么 传 入 的 name 应 该 加 入 前 级 & 

if (!(beanInstance instanceof FactoryBean) || BeanFact 
oryUtils. IsFactory 
Dereference(name)) { 

return beanInstance; 





























j 


// 加 载 FactoryBean 
Object object = null; 
if (mbd == null) { 
// 尝 试 从 缓存 中 加 载 bean 
object = getCachedObjectForFactoryBean(beanName); 


} 

if (object == null) { 
// 到 这 里 已 经 明确 知道 beanInstance 一 定 是 FactoryBean 类 型 
FactoryBean<?> factory = (FactoryBean<?>) beanInst 

















ance; 
//containsBeanDefinitionfjJllbeanDefinitionMap"Ht 5 
是 在 所 有 已 经 加 载 的 类 中 检测 
// 是 否定 义 beanName 
if (mbd == null && containsBeanDefinition(beanName 











)) 1 














// 将 存储 XML 配置 文件 的 GernericBeanDefinition 转 换 为 
RootBeanDefinition， 如 
// 果 指定 BeanName 是 子 Bean 的 话 同时 会 合并 父 类 的 相关 属性 
mbd = getMergedLocalBeanDefinition(beanName); 














/是 否 是 用 户 定 义 的 而 不 是 应 用 程序 本 身 定义 的 
synthetic = (mbd != null && mbd.isSyntheti 








c()); 


object - getObjectFromFactoryBean 
(factory, beanName, !synthetic); 


return object; 














从 上 面 的 代码 来 看 ， 其 实 这 个 方法 并 没有 什么 


重要 的 信息 ， 大 多 是 些 辅助 代码 以 及 一 些 功能 性 的 
判断 ， 而 真正 的 核心 代码 却 委 托 给 了 
getObjectFromFactoryBean， 我 们 来 看 看 
getObjectForBeanInstance 中 的 所 做 的 工作 。 

1. 对 FactoryBean 正 确 性 的 验证 。 

2. 对 非 FactoryBean 不 做 任何 处 理 。 

3. 对 bean 进 行 转换 。 


4. 将 从 Factory 中 解析 bean 的 工作 委托 给 
getObjectFromFactoryBean. 





protected Object getObjectFromFactoryBean(FactoryBean factory, 
String beanName, Boolean 
shouldPostProcess) 
// 如 果 是 单 例 模 式 


if (factory.isSingleton() && containsSingleton(beanNam 


e)) { 
synchronized (getSingletonMutex()) (1 


Object object - this.factoryBeanObjectCache.ge 
t(beanName); 


if (object -- null) ( 


object - doGetObjectFromFactoryBean 
(factory, beanName, shouldPostProcess); 
this.factoryBeanObjectCache.put(beanName, 
(object !- null ? object : NULL OBJECT)); 
} 
return (object !- NULL OBJECT ? object : null) 
} 


else ( 
return doGetObjectFromFactoryBean 


(factory, beanName, shouldPostProcess); 


j 





很 遗憾 ， 在 这 个 代码 中 我 们 还 是 没有 看 到 想 要 





看 到 的 代码 ， 在 这 个 方法 里 只 做 了 一 件 事情 ， 惑 是 
返回 的 bean 如 条 是 单 例 的 ， 那 殉 必 须要 保证 全 局 唯 
一 ， 同 时 ， 也 因为 是 单 例 的 ， 所 以 不 必 重 复 创建 ， 
可 以 使 用 绥 存 来 提高 性 能 ， 也 融 是 说 已 经 加 载 过 残 
BWK PRET PREH, FUREN ERIR 
To 


在 doGetObjectFromFactoryBean 方 法 中 我 们 终 
于 看 到 了 我 们 想 要 看 到 的 方法 ， 也 就 是 object = 
factory.getObject()， 是 的 ， 就 是 这 人 句 代 人 码 ， 我 们 的 
历程 狐 如 和 剥 洋 芍 一 样 ， 一 层 一 层 的 直到 最 内 部 的 代 
码 实 现 ， 虽 然 很 简单 。 


private Object doGetObjectFromFactoryBean( 





























final FactoryBean factory, final String beanName, 
final boolean shouldPostProcess) 
throws BeanCreationException { 


Object object; 
try { 
// 需 要 权限 验证 
if (System.getSecurityManager() !- null) { 
AccessControlContext acc - getAccessControlCon 











text(); 
try { 
object - AccessController.doPrivileged(new 
PrivilegedException 
Action« Object>() ( 
public Object run() throws Exception { 
return factory.getObject(); 
} 
}, acc); 
} 
catch (PrivilegedActionException pae) { 
throw pae.getException(); 





} 
} 
else ( 

// 直 接 调用 get0bject 方 法 

object = factory.getObject(); 
} 


j 


catch (FactoryBeanNotInitializedException ex) { 
throw new BeanCurrentlyInCreationException(beanNam 
e, ex.toString()); 


} 
catch (Throwable ex) { 
throw new BeanCreationException(beanName, "Factory 
Bean threw exception on object creation", ex); 


if (object == null && isSingletonCurrentlyInCreation(b 
eanName)) ( 
throw new BeanCurrentlyInCreationException( 
beanName, "FactoryBean which is currently 
in creation returned 
null from getObject"); 


j 


if (object !- null && shouldPostProcess) ( 
try { 
// 调 用 0bjectFactory 的 后 处 理 器 
object = postProcessObjectFromFactoryBean 

















(object, beanName); 
} 
catch (Throwable ex) { 
throw new BeanCreationException(beanName, "Pos 


t-processing of the 
FactoryBean's object failed", ex); 


j 


return object; 





上 面 我 们 已 经 讲述 了 FactoryBean 的 调用 方法 ， 
如 果 bean 声 明 为 FactoryBean 类 型 ， 则 当 提 取 bean 时 
提取 的 并 不 是 FactoryBean， 而 是 FactoryBean 中 对 应 
的 getObject 方 法 返回 的 bean， 而 
doGetObjectFromFactoryBean 正 是 实现 这 个 功能 
的 。 但 是 ， 我 们 看 到 在 上 面 的 方法 中 除了 调用 
object = factory.getObjectO 得 到 我 们 想 要 的 结果 后 并 








没有 直接 返回 ， 而 是 接 下 来 又 做 了 些 后 处 理 的 操 
作 ， 这 个 又 是 做 什么 用 的 呢 ? 于 是 我 们 跟踪 进入 
AbstractAutowireCapableBeanFactory 类 的 
postProcessObjectFromFactoryBean 方 法 : 


AbstractAutowireCapableBeanFactory.java 


protected Object postProcessObjectFromFactoryBean(Object object 


, String beanName) ( 
return applyBeanPostProcessorsAfterInitialization 


(object, beanName); 


public Object applyBeanPostProcessorsAfterInitialization(Object 
existingBean, String beanName) 
throws BeansException { 


Object result - existingBean; 
for (BeanPostProcessor beanProcessor : getBeanPostProc 
essors()) ( 
result = beanProcessor.postProcessAfterInitializat 
ion(result, beanName); 
if (result -- null) ( 
return result; 
} 
} 


return result; 





对 于 后 处 理 右 的 使 用 我 们 还 未 过 多 接触 ， 后 续 





章节 会 使 用 大 量 篇 幅 介 绍 ， 这 里 ， 我 们 只 需 了 解 在 
Spring 获取 bean 的 规则 中 有 这 样 一 条 : 尽 可 能 保证 
所 有 bean 初 始 化 后 都 会 调用 注册 的 
BeanPostProcessor 的 postProcessSAfterInitialization 方 
法 进行 处 理 ， 在 实际 开发 过 程 中 大 可 以 针对 此 特性 
设计 自己 的 业务 逻辑 。 


5.4 获取 单 例 


之 前 我 们 讲解 了 从 缓存 中 获取 单 例 的 过 程 ， 那 








么 ， 如 果 组 存 中 不 存在 已 经 加 载 的 单 例 bean 就 需要 
从 头 开 始 bean 的 加 载 过 程 了 ， 而 Spring 中 使 用 
getSingleton 的 重 载 方法 实现 bean 的 加 载 过 程 。 








public Object getSingleton(String beanName, ObjectFactory singl 
etonFactory) ( 
Assert.notNull(beanName, "'beanName' must not be null" 


); 





// 全 局 变量 需要 同步 
synchronized (this.singletonObjects) { 
// 首 先 检 查 对 应 的 bean 是 否 已 经 加 载 过 ， 因 为 singLeton 模 式 其 实 
就 是 复 用 以 创建 的 bean， 
// 所 以 这 一 步 是 必须 的 
Object singletonObject = this.singletonObjects.get 











(beanName); 
// 如 果 为 空 才 可 以 进行 Singleto 的 bean 的 初始 化 
if (singletonObject == null) { 
if (this.singletonsCurrentlyInDestruction) { 
throw new BeanCreationNotAllowedException( 
beanName, 
"Singleton bean creation not allow 
ed while the singletons of this factory are in destruction " + 
"(Do not request a bean from a Bea 
nFactory in a destroy 
method implementation!)"); 


y 
if (logger.isDebugEnabled()) { 
logger.debug("Creating shared instance of 
Singleton bean '" + beanName + "'"); 


beforeSingletonCreation 


(beanName); 
boolean recordSuppressedExceptions - (this.sup 
pressedExceptions -- null); 
if (recordSuppressedExceptions) { 
this.suppressedExceptions - new LinkedHash 
Set«Exception»(); 


try { 
// 初 始 化 bean 
singletonObject = singletonFactory.getObje 


ct(); 


catch (BeanCreationException ex) { 
if (recordSuppressedExceptions) { 
for (Exception suppressedException : t 


his.suppressedExceptions) ( 
ex.addRelatedCause(suppressedExcep 


tion); 
} 
} 
throw ex; 
} 
finally { 


if (recordSuppressedExceptions) { 
this.suppressedExceptions - null; 


afterSingletonCreation 


(beanName); 


} 
// 加 入 缓存 
addSingleton 


(beanName, singletonObject); 


} 
return (singletonObject !- NULL OBJECT ? singleton 


Object : null); 
} 


} 











上 述 代码 中 其 实 是 使 用 了 回调 方法 ， 使 得 程序 
可 以 在 单 例 创建 的 前 后 做 一 些 准备 及 处 理 操作 ， 而 





真正 的 获取 单 例 bean 的 方法 其 实 并 不 是 在 此 方法 中 
实现 的 ， 其 实现 逻辑 是 在 ObjectFactory 类 型 的 实例 
singletonFactory 中 实现 的 。 而 这 些 准 备 及 处 理 操作 
包括 如 下 内 容 。 





1. 检查 缓存 是 否 已 经 加 载 过 。 


2. 在 没有 加 载 ， 则 记录 beanName 的 正在 加 载 
状态 。 


3. 加载 单 例 前 记录 加 载 状态 。 








可 能 你 会 觉得 beforeSingletonCreation 方 法 是 个 
TKI, FTCA Ee, (ASCE, KDB 
数 中 做 了 一 个 很 重要 的 操作 : 记录 加 载 状 态 ， 也 就 
是 通过 this.singletonsCurrentlyIn- 
Creation.add(beanName) 将 当前 正 要 创建 的 bean 记录 
在 绥 存 中 ， 这 样 便 可 以 对 循环 依赖 进行 检测 。 





protected void beforeSingletonCreation(String beanName) { 
if (!this.inCreationCheckExclusions.contains(beanName) 


&& !this.singletons 
CurrentlyInCreation.add(beanName)) { 
throw new BeanCurrentlyInCreationException(beanNam 


j 


e); 





4. 通过 调用 参数 传 入 的 ObjectFactory 的 个 体 
Object 方 法 实例 化 bean。 


5. 加 载 单 例 后 的 处 理 方法 调用 。 
同步 骤 3 的 记录 加 载 状态 相似 ， 当 bean 加 载 结 





束 后 需要 移 除 缓存 中 对 该 bean 的 正在 加 载 状态 的 记 
Ko 


protected void afterSingletonCreation(String beanName) { 
if (!this.inCreationCheckExclusions.contains(beanName) 
&& !this.singletons 
CurrentlyInCreation.remove(beanName)) { 
throw new IllegalStateException("Singleton '" + be 


anName + "' isn't 

currently in creation"); 
} 

} 





6. 将 结果 记录 至 绥 存 并 删 际 加 载 bean 过 程 中 
所 记录 的 各 种 辅助 状态 。 


protected void addSingleton(String beanName, Object singletonOb 
ject) { 
synchronized (this.singletonObjects) { 
this.singletonObjects.put(beanName, (singletonObje 
ct != null ? singletonObject : NULL OBJECT)); 
this.singletonFactories.remove(beanName); 


this.earlySingletonObjects.remove(beanName); 
this.registeredSingletons.add(beanName); 


J 








7. 返回 处 理 结 


虽然 我 们 已 经 从 外 部 了 解 了 加 载 bean 的 逻辑 架 
构 ， 但 现在 我 们 还 并 没有 开始 对 bean 加 载 功能 的 探 
索 ， 之 前 提 到 过 ，bean 的 加 载 逻辑 其 实 古 在 传 入 的 
ObjectFactory 类 型 的 参数 singletonFactory 中 定义 





的 ， 我 们 反 推 参数 的 获取 ， 得 到 如 下 代码 : 


sharedInstance = getSingleton(beanName, new ObjectFactory 


<Object>() { 
public Object getObject() throws BeansExce 
ption { 
try { 
return createBean 


(beanName, mbd, args); 


catch (BeansException ex) { 
destroySingleton(beanName); 
throw ex; 
} 
} 
+); 








ObjectFactory 的 核心 部 分 其 实 只 是 调用 了 
createBean 的 方法 ， 所 以 我 们 还 需要 到 createBean 方 
法 中 退 寻 真理 。 


5.5 准备 创建 bean 


我 们 不 可 能 指望 在 一 个 函数 中 完成 一 个 复杂 的 
馆 辑 ， 而 且 我 们 跟踪 了 这 么 多 Spring 代码 ， 经 历 了 
这 么 多 阔 数 ， 或 多 或 少 也 发 现 了 一 些 规律 一 个 真 
正 干 活 的 函数 其 实 是 以 do 开头 的 ， 比 如 
doGetObjectFromFactoryBean; 而 给 我 们 错觉 的 函 





数 ， 比 如 getObjectFromFactoryBean， 其 实 只 是 从 全 
局 角度 去 做 些 统筹 的 工作 。 这 个 规则 对 于 
createBean 也 不 例外 ， 那 么 让 我 们 看 看 在 createBean 
函数 中 做 了 哪些 准备 工作 。 








protected Object createBean(final String beanName, final RootBe 
anDefinition mbd, final Object[] args) throws BeanCreationEx 
ception ( 


if (logger.isDebugEnabled()) { 
logger.debug("Creating instance of bean '" + beanN 
ame + A E 


} 
// 锁 定 cLlass, 根据 设置 的 class 属 性 或 者 根据 className 来 解析 Class 
resolveBeanClass(mbd, beanName); 




















// 验 证 及 准备 覆盖 的 方法 
try { 
mbd.prepareMethodOverrides(); 


j 


catch (BeanDefinitionValidationException ex) { 
throw new BeanDefinitionStoreException(mbd.getReso 
urceDescription(), 
beanName, "Validation of method overrides 
failed", ex); 


try { 
// 给 BeanPostProcessors 一 个 机 会 来 返回 代理 来 蔡 代 真正 的 实例 
Object bean = resolveBeforeInstantiation 





























(beanName, mbd); 
if (bean != null) { 
return bean; 


j 


catch (Throwable ex) { 
throw new BeanCreationException(mbd.getResourceDes 
cription(), beanName, 


"BeanPostProcessor before instantiation of 
bean failed", ex); 


Object beanInstance - doCreateBean 


(beanName, mbd, args); 
if (logger.isDebugEnabled()) { 


logger .debug("Finished creating instance of bean ' 
" + beanName + "t ") . 


return beanInstance; 


j 





MASS PRAT BY ES 28 HER C E ELVIS R 
及 功能 。 


1. 根据 设置 的 class 属 性 或 者 根据 className 来 
解析 Class。 


2. 对 override 属 性 进行 标记 及 验证 。 








很 多 读者 可 能 会 不 知道 这 个 方法 的 作用 ， 因 为 
在 Spring 的 配置 里 面 根本 就 没有 诸如 override- 
method 之 类 的 配置 ， 那 么 这 个 方法 到 底 是 干什么 用 
的 呢 ? 





其 实在 Spring 中 确实 没有 override-method 这 样 
的 配置 ， 但 是 如 采 读 过 前 面 的 部 分 ， 可 能 会 有 所 及 
现 ， 在 Spring 配置 中 是 存在 lookup-method 和 replace- 
method 的 ， 而 这 两 个 配置 的 加 载 其实 束 是 将 配置 红 














一 存放 在 BeanDefinition 中 的 methodOverrides 必 性 
里 ， 而 这 个 函数 的 操作 其 实 也 就 是 针对 于 这 两 个 配 
置 的 。 


3. 应 用 初始 化 前 的 后 处 理 袁 ， 解 析 指 定 bean 
是 售 存 在 初始 化 前 的 短路 操作 。 


4. 创建 bean。 


我 们 首先 查看 下 对 override 属 性 标记 及 验证 的 
逻辑 实现 。 








5.5.1 ”人 处理 override 属 性 


查看 源码 中 AbstractBeanDefinition 类 的 
prepareMethodOverrides 方 法 : 





public void prepareMethodOverrides() throws BeanDefinitionValid 
ationException ( 

// Check that lookup methods exists. 

MethodOverrides methodOverrides - getMethodOverrides() 


if (!methodOverrides.isEmpty()) { 
for (MethodOverride mo : methodOverrides.getOverri 


des()) 1 


prepareMethodOverride 
(mo); 
} 
} 


protected void prepareMethodOverride(MethodOverride mo) throws 


BeanDefinitionValidationException { 
// 获 取 对 应 类 中 对 应 方法 名 的 个 数 
int count = ClassUtils.getMethodCountForName(getBeanCl 
ass(), mo.getMethodName( )); 
if (count == 0) { 
throw new BeanDefinitionValidationException( 
"Invalid method override: no method with n 
ame '" + mo.getMethodName() + 
"' on class [" + getBeanClassName() + "]") 





else if (count == 1) { 
// 标 记 Methodoverride 和 暂 未 被 覆盖 ， 避 免 参数 类 型 检查 的 开销 。 
mo.setOverloaded(false); 


j 





通过 以 上 两 个 函数 的 代码 你 能 体会 到 它 所 要 实 





现 的 功能 吗 ? 之 前 反复 提 到 过 ， 在 Spring 配置 中 存 
在 lookup-method 和 replace-method 两 个 配置 功能 ， 

而 这 两 个 配置 的 加 载 其 实 就 古 将 配置 统一 存放 在 
BeanDefinition 中 的 methodOverrides 属 性 里 ， 这 两 个 
功能 实现 原理 其 实 是 在 bean 实 例 化 的 时 候 如 果 检 测 
到 存在 methodOverrides 属 性 ， 会 动态 地 为 当前 bean 
生成 代理 并 使 用 对 应 的 拦截 器 为 bean 做 增强 处 理 ， 
相关 逻辑 实现 在 bean 的 实例 化 部 分 详细 介绍 。 


但 是 ， 这 里 要 所 到 的 是 ， 对 于 方法 的 匹配 来 
W, WRT ERT TBR, ALA, Æ 
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古 ，Spring 将 一 部 分 匹配 工作 在 这 里 完成 了 ， 如 果 
当前 类 中 的 方法 只 有 一 个 ， 那 么 就 设置 重 载 该 方法 
没有 被 重 载 ， 这 样 在 后 续 调 用 的 时 候 便 可 以 直接 使 
用 找到 的 方法 ， 而 不 需要 进行 方法 的 参数 匹配 验证 
了 ， 而 且 还 可 以 提前 对 方法 存在 性 进行 验证 ， 正 可 
TH — Bi OEE o 











5.5.2 ”实例 化 的 前 置 处 理 





在 真正 调用 doCreate 方 法 创建 bean 的 实例 前 使 

用 了 这 样 一 个 方法 resolveBeforelInstantiation 
(beanName, mbd) 对 BeanDefinigiton 中 的 属性 做 些 前 
置 处 理 。 当 然 ， 无 论 其 中 是 否 有 相应 的 迎 辑 实现 我 
们 都 可 以 理解 ， 因 为 真正 逻辑 实现 前 后 留 有 处 理 函 
数 也 是 可 扩展 的 一 种 体现 ， 但 是 ， 这 并 不 是 最 重要 
的 ， 在 函数 中 还 提供 了 一 个 短路 判断 ， 这 才 是 最 为 
关键 的 部 分 。 


if (bean !- null) { 
return bean; 





j 








当 经 过 前 置 处 理 后 返回 的 结果 如 果 不 为 空 ， 那 
么 会 直接 略 过 后 续 的 bean 的 创建 而 直接 返回 结果 。 
这 一 特性 虽然 很 容易 被 忽略 ， 但 是 却 起 着 至 关 重 要 
的 作用 ， 我 们 熟知 的 AOP 功 能 就 是 基于 这 里 的 判断 








protected Object resolveBeforeInstantiation(String beanName, Ro 
otBeanDefinition mbd) ( 

Object bean = null; 
// 如 果 尚 未 被 解析 


if (!Boolean.FALSE.equals(mbd.beforeInstantiationResol 





ved)) { 
// Make sure bean class is actually resolved at th 
is point. 
if (mbd.hasBeanClass() && !mbd.isSynthetic() && ha 
sInstantiationAware 
BeanPostProcessors()) { 
bean - applyBeanPostProcessorsBeforeInstantiat 
ion 
(mbd.getBeanClass(), beanName); 
if (bean != null) { 
bean = applyBeanPostProcessorsAfterInitial 
ization 


(bean, beanName) ; 


j 


mbd.beforelnstantiationResolved - (bean !- null); 


return bean; 








此 方法 中 最 吸引 我 们 的 无 疑 是 两 个 方法 
applyBeanPostProcessorsBeforeInstantiation 以 及 
applyBeanPostProcessorsAfterInitialization。 两 个 方 
法 实现 的 非常 简单 ， 无 非 是 对 后 处 理 硕 中 的 所 有 
InstantiationAwareBeanPostProcessor 类 型 的 后 处 理 
Ait Xt 1T postProcessBeforelnstantiation 7] 12; Fil 
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法 的 调用 。 
1. 实例 化 前 的 后 处 理 占 应 用 


bean 的 实例 化 前 调用 ， 也 就 是 将 
AbsractBeanDefinition 转 换 为 BeanWrapper 前 的 处 
理 。 给 子 类 一 个 修改 BeanDefinition 的 机 会 ， 也 就 是 
说 当 程 序 经 过 这 个 方法 后 ，bean 可 能 已 经 不 是 我 们 
认为 的 bean 了 ， 而 是 或 许 成 为 了 一 个 经 过 处 理 的 代 
理 bean， 可 能 是 通过 cglib 生 成 的 ， 也 可 能 是 通过 其 
他 技术 生成 的 。 这 在 第 7 章 中 会 详细 介绍 ， 我 们 只 
需要 知道 ， 在 bean 的 实例 化 前 会 调用 后 处 理 器 的 方 
TAME TT Mb FE 














protected Object applyBeanPostProcessorsBeforeInstantiation(Cla 
ss beanClass, String beanName) 
throws BeansException ( 


for (BeanPostProcessor bp : getBeanPostProcessors()) { 
if (bp instanceof InstantiationAwareBeanPostProces 


InstantiationAwareBeanPostProcessor ibp - (Ins 
tantiation AwareBean 
PostProcessor) bp; 

Object result - ibp.postProcessBeforeInstantia 
tion 


(beanClass, beanName); 
if (result !- null) ( 
return result; 


j 
j 
j 


return null; 
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在 讲解 从 绥 存 中 获取 单 例 bean 的 时 候 残 提 到 
过 ，Spring 中 的 规则 是 在 bean 的 初始 化 后 尽 可 能 保 
证 将 注册 的 后 处 理 器 的 postProcessAfterInitialization 
方法 应 用 到 该 bean 中 ， 因 为 如 果 人 返回 的 bean 不 为 
空 ， 那 么 便 不 会 再 次 经 历 普 通 bean 的 创建 过 程 ， 所 
以 只 能 在 这 里 应 用 后 处 理 需 的 
postProcessAfterInitialization 方 法 。 











public Object applyBeanPostProcessorsAfterInitialization(Object 
existingBean, String beanName) 
throws BeansException { 


Object result - existingBean; 
for (BeanPostProcessor 


beanProcessor : getBeanPostProcessors()) { 
result = beanProcessor.postProcessAfterInitializat 
ion 


(result, beanName) ; 
if (result == null) { 
return result; 


J 


return result; 


| 
5.6 ”循环 依赖 


实例 化 bean 是 一 个 非常 复杂 的 过 程 ， 而 其 中 比 
较 难 以 理解 的 就 是 对 循环 依赖 的 解决 ， 不 管 之 前 读 
者 有 没有 对 循环 依赖 方面 的 研究 ， 这 里 有 必要 先 对 
此 知识 点 稍 作 回顾 。 








5.6.1 什么 是 循环 依赖 





循环 依赖 就 是 循环 引用 ， 就 是 两 个 或 多 个 bean 
相互 之 间 的 持 有 对 方 ， 比 如 CircleA 引 用 CircleB， 
CircleB 引 用 CircleC，CircleC 引 用 CircleA， 则 它们 
最 终 反 映 为 一 个 环 。 此 处 不 是 循环 调用 ， 循 环 调用 
是 方法 之 间 的 环 调 用 ， 如 图 5-2 所 示 。 





«Java Class» 











TestA 
| — QT RT «Java Classs 
9 test: TestB (3 TestB 
| | «uses j | 
i | s testC : TestC 
© getTestB () rat 
© setTestB () © getTestc () 
@ setTestC () 
use» -A eis nea acta use Peer ge ae eee oe ee 





«Java Class» 
| (9 Teste 
o testA: TestA 
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图 5-2 ”循环 依赖 
循环 调用 是 无 法 解决 的 ， 除 非 有 终结 条 件 ， 否 
则 束 是 死 循环 ， 最 终 导 至 内存 洲 出 错误 。 
5.6.2. ”Spring 如 何 解 决 循环 依赖 


Spring 容 右 循 坏 依赖 包括 构造 占 循 环 依赖 和 
setter 循 环 依赖 ， 那 Spring 容器 如 何 解决 循环 依赖 
呢 ? 首先 让 我 们 来 定义 循环 引用 关 ; 


public class TestA ( 
private TestB testB; 


public void a() { 
testB.b(); 


public TestB getTestB() ( 
return testB; 


Jj 


public void setTestB(TestB testB) { 
this.testB - testB; 
} 
} 


public class TestB ( 
private TestC testC; 


public void b() { 
testC.c(); 


public TestC getTestC() ( 
return testC; 


j 


public void setTestC(TestC testC) { 
this.testC - testC; 
} 
} 


public class TestC ( 
private TestA testA; 


public void c() { 
testA.a(); 


public TestA getTestA() { 
return testA; 


j 


public void setTestA(TestA testA) { 
this.testA - testA; 


j 





在 Spring 中 将 循环 依赖 的 处 理 分 成 了 3 种 情况 。 
1. [43588 B P TCR 
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是 无 法 解决 的 ， 只 能 抛 出 BeanCurrentlyIn- 
CreationException 腊 第 表示 循环 依赖 。 


如 在 创建 TestA 类 时 ， 构 造 占 需要 TestB 类 ， 那 
将 去 创建 TestB， 在 创建 TestB 类 时 又 发 现 需 要 TestC 
类 ， 则 又 去 创建 TestC， 最 终 在 创建 TestC 时 发 现 叉 
需要 TestA， 从 而 形成 一 个 环 ， 没 办 法 创建 。 


Spring 容 右 将 每 一 个 正在 创建 的 bean 标 识 符 放 
竺 一 个 “当前 创建 bean 池 ”中 ，bean 标 识 符 在 创建 过 
程 中 将 一 直 保 持 在 这 个 池 中 ， 因 此 如 果 在 创建 bean 
过 程 中 友 现 目 己 已 经 在 “当前 创建 bean 闻 ”里 时 ， 将 
Hü 44 BeanCurrentlyInCreationException-? fi 4€ zs 4j ^ 
依赖 ， 而 对 于 创建 完毕 的 bean 将 从 “当前 创建 bean 
闻 ” 中 清除 挥 。 


我 们 通过 一 个 直观 的 测试 用 例 来 进行 分 析 。 
1. 创建 配置 文件 。 








«bean id="testA" class="com.bean.TestA"> 
«constructor-arg index="0" ref="testB"/> 


«/bean» 

«bean id="testB" class="com.bean.TestB"> 
«constructor-arg index="0" ref="testC"/> 

</bean> 

<bean id="testC" class="com.bean.TestC"> 
«constructor-arg index="0" ref="testA"/> 

</bean> 





2. 创建 测试 用 例 。 


QTest(expected = BeanCurrentlyInCreationException.class) 
public void testCircleByConstructor() throws Throwable { 


try { 
new ClassPathXmlApplicationContext("test.xml"); 


) catch (Exception e) ( 








// 因 为 要 在 创建 testC 时 抛 出 ; 
Throwable e1 = e.getCause().getCause().getCause(); 
throw e1; 





针对 以 上 代码 的 分 析 如 下 。 


e Spring 容器 创建 *testA”bean， 首 先 去 “当前 创建 
bean 池 ”查找 是 否 当前 bean 正 在 创建 ， 如 果 没 发 
现 ， 则 继续 准备 其 需要 的 构造 右 参 数 "testB?”， 
并 将 “testA” 标 识 符 放 到 “当前 创建 bean 闻 ”。 

。Spring 容 器 创建 “testB”bean， 首 先 去 “当前 创建 
bean 池 ”查找 是 否 当 前 bean 正 在 创建 ， 如 果 没 发 
现 ， 则 继续 准备 其 需要 的 构造 右 参 数 “"testC?”， 
并 将 “testB” 标 识 符 放 到 “当前 创建 bean 池 ?”。 


。Spring 容 器 创建 <*testC”bean， 首 先 去 “当前 创建 
bean 池 ”查找 是 否 当前 bean 正 在 创建 ， 如 果 没 发 
现 ， 则 继续 准备 其 需要 的 构造 器 参数 "testA”， 
并 将 “testC” 标 识 符 放 到 “当前 创建 bean 池 ”。 

。 到 此 为 止 Spring 容 器 要 去 创建 “testA”bean， 发 现 
该 bean 标 识 从 在 “当前 创建 bean 池 ”中 ， 因 为 表示 
循环 依赖 ， 抛 出 


BeanCurrentlyInCreationException. 


2. setter 循 环 依 赖 





表示 通过 setter 注 入 方式 构成 的 循环 依赖 。 对 于 
setter 注 入 造成 的 依赖 是 通过 Spring 容 如 提前 暴露 刚 
完成 构造 右 注 入 但 未 完成 其 他 步 又 (如 setter 注 入 ) 
的 bean 来 完成 的 ， 而 且 只 能 解决 单 例 作 用 域 的 bean 
循环 依赖 。 通 过 提前 暴露 一 个 蛙 例 工厂 方法 ， 从 而 
使 其 他 bean 能 引用 到 该 bean， 如 下 代码 所 示 : 











addSingletonFactory(beanName, new ObjectFactory() { 
public Object getObject() throws BeansException { 
return getEarlyBeanReference(beanName, mbd, bean); 





具体 步骤 如 下 。 
1. Spring 容器 创建 单 例 *testA”bean， 首 先 根据 


无 参 构造 器 创建 beaan， 并 暴露 一 
个 “ObjectFactory” 用 于 返回 一 个 提前 暴露 一 个 创建 
中 的 bean， 并 将 “testA” 标 识 符 放 到 “当前 创建 bean 
池 ”， 然 后 进行 setter 注 入 “testB”。 


2. Spring ARAJE] “testB”bean, HER HE 
无 参 构 造 右 创建 bean， 并 骏 露 一 
个 “ObjectFactory” 用 于 返回 一 个 提前 骏 露 一 个 创建 
中 的 bean， 并 将 “testB” 标 识 符 放 到 “当前 创建 bean 
池 ”， 然 后 进行 setter 注 入 “circle”。 


3. Spring 容 右 创 建 单 例 “testC”bean， 首 先 根 据 
TAH 48 Bll bean, FFAS — 
“4“ObjectFactory” H FiB [n] — $e Bj 28 88 — 1 G1] 
中 的 bean， 并 将 “testC” 标 识 符 放 到 “当前 创建 bean 
池 ”， 然 后 进行 setter 注 入 “testA”。 进 行 注 
A“testA” E FAS A eS J *ObjectFactory" LJ , 
Jf f Fre In pe Bt ae ee — PB EF bean 。 


4. 最 后 在 依赖 注入 “testB” 和 “testA”， 完 成 
setter 注 入 。 








3. prototype 汇 围 的 依赖 处 理 


对 于 “prototype” 作 用 域 bean，Spring 容 器 无 法 
完成 依赖 注入 ， 因 为 Spring 容 如 不 进行 绥 


存 “prototype” 作 用 域 的 bean， 因 此 无 法 提前 暴露 一 
个 创建 中 的 bean。 示 例如 下 : 


1. 创建 配置 文件 。 


«bean id="testA" class="com.bean.CircleA" scope="prototype"> 
«property name="testB" ref="testB"/> 
</bean> 
<bean id="testB" class="com.bean.CircleB" scope="prototype"> 


<property name="testC" ref="testC"/> 


</bean> 
<bean id="testC" class="com.bean.CircleC" scope="prototype"> 


«property name="testA" ref="testA"/> 
</bean> 





2. 创建 测试 用 例 。 


QTest(expected = BeanCurrentlyInCreationException.class) 
public void testCircleBySetterAndPrototype () throws Throwable 
{ 


try { 
ClassPathXmlApplicationContext ctx = new ClassPathXmlAp 


plicationContext( 
"testPrototype.xml"); 


System.out.println(ctx.getBean("testA")); 

) catch (Exception e) ( 
Throwable e1 = e.getCause().getCause( ).getCause( ); 
throw e1; 





XJ] F “singleton” H]3Xbean, "JLAM 
iw“setAllowCircularReferences(false) ; "2K25/H48 


环 引 用 。 


感谢 互联 网 时 代 ， 让 我 可 以 方便 地 获取 我 想 要 
的 各 种 信息 ， 当 初 我 刚 开 始 学 习 的 时 候 ， 一 直 纠 结 
于 这 里 错综复杂 的 馆 辑 ， 科 好 我 看 到 了 一 篇 文章 解 
开 了 我 心中 的 疑惑 。 在 此 ， 感 谢 原 作者 ， 并 将 原文 
GRADE, PKA LE AY BEES pring Hy HOR, 
大 家 可 以 从 
http://www.iflym.com/index.php/code/201208280001.h 
来 获取 原文 。 








5.7 ”创建 bean 


介绍 了 循环 依赖 以 及 Spring 中 的 循环 依赖 的 处 
理 方式 后 ， 我 们 继续 4.5 节 的 内 容 。 当 经 历 过 
resolveBeforeInstantiation 方 法 后 ， 程 序 有 两 个 选 
择 ， 如 果 创 建 了 代理 或 者 说 重 写 了 
InstantiationAwareBeanPostProcessor 的 
postProcessSBeforeInstantiation 方 法 并 在 方法 
postProcess- BeforeInstantiation 中 改变 了 bean， 则 直 
BOREIA LAT, AU EHI a beani EE. 
Tfj ix Fe bean hel E zE doCreateBean F 7E EX, 

的 。 


protected Object doCreateBean(final String beanName, final Root 
BeanDefinition mbd, final 








Object[] args) { 
// Instantiate the bean. 
BeanWrapper instanceWrapper = null; 
if (mbd.isSingleton()) (1 
instanceWrapper = this.factoryBeanInstanceCache.re 
move(beanName) ; 


if (instanceWwrapper == null) { 
// 根 据 指 定 bean 使 用 对 应 的 策略 创建 新 的 实例 ， 如 : 工厂 方法 、 构 
造 函 数 自动 注入 、 简 单 初 始 化 


instanceWrapper = createBeanInstance 








(beanName, mbd, args); 


final Object bean = (instanceWrapper !- null ? instanc 
ewrapper. getWrappedInstance() : null); 
Class beanType = (instanceWrapper !- null ? instanceWr 


apper.getWrappedClass() : null); 


// Allow post-processors to modify the merged bean def 
inition. 
synchronized (mbd.postProcessingLock) { 
if (!mbd.postProcessed) ( 
//NiRjMergedBeanDefinitionPostProcessor 
applyMergedBeanDefinitionPostProcessors(mbd, b 
eanType, beanName); 
mbd.postProcessed - true; 











是 否 需要 提早 上 曝光: 单 例 & 允 许 循 环 依赖 & 当 前 bean 正 在 创建 中 ， 检 测 





=R 


循环 依赖 
ay 
boolean earlySingletonExposure = (mbd.isSingleton() && 
this.allowCircularReferences && 


isSingletonCurrentlyInCreation(beanName)); 


if (earlySingletonExposure) { 
if (logger.isDebugEnabled()) (1 
logger.debug("Eagerly caching bean '" + beanNa 
me + 


"' to allow for resolving potential ci 
rcular references"); 








} 

// 为 避免 后 期 循环 依赖 ， 可 以 在 bean 初 始 化 完成 前 将 创建 实例 的 0bj 
ectFactory 加 入 工厂 

addSingletonFactory(beanName, new ObjectFactory() 


1 
ni 


public Object getObject() throws BeansExceptio 





// 对 bean 再 一 次 依赖 引用 ， 主 要 应 用 SmartInstantiat 
ionAware BeanPost 

//Processor 

// 其 中 我 们 熟知 的 AOP 就 是 在 这 里 将 advice 动 态 织 入 bea 
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//bean， 不 做 任何 处 理 
return getEarlyBeanReference(beanName, mbd 








, bean); 


}); 
} 


// Initialize the bean instance. 
Object exposedObject = bean; 
try { 
// 对 bean 进 行 填充 ， 将 各 个 属性 值 注入 ， 其 中 ， 可 能 存在 依赖 于 其 
他 bean 的 属性 ， 则 会 递归 初始 
// 依 赖 bean 
populateBean 











(beanName, mbd, instanceWrapper); 
if (exposedObject !- null) { 
// 调 用 初始 化 方法 ， 比 如 init-method 
exposedObject = initializeBean 





(beanName, exposedObject, mbd); 


j 


} 
catch (Throwable ex) { 
if (ex instanceof BeanCreationException && beanNam 
e.equals(((BeanCreationException) ex).getBeanName())) { 
throw (BeanCreationException) ex; 
} 
else ( 
throw new BeanCreationException(mbd.getResourc 
eDescription(), beanName, "Initialization of bean failed", ex); 


j 


if (earlySingletonExposure) { 


Object earlySingletonReference = getSingleton(bean 
Name, false); 

//ear1lySingletonReference 只 有 在 检测 到 有 循环 依赖 的 情况 下 
才 会 不 为 空 














if (earlySingletonReference !- null) { 
// 如 果 exposed0bject 没 有 在 初始 化 方法 中 被 改变 ， 也 就 是 没 











有 被 增强 








if (exposedObject == bean) { 
exposedObject = earlySingletonReference; 
jelse if (!this.allowRawInjectionDespiteWrappi 
ng && hasDependentBean (beanName)) ( 
String[] dependentBeans - getDependentBean 
s(beanName); 
Set«String» actualDependentBeans - new Lin 
kedHashSet«String» 
(dependentBeans.length); 
for (String dependentBean : dependentBeans 
) i 
// 检 测 依赖 
if (!removeSingletonIfCreatedForTypech 
eckOnly(dependentBean)) { 
actualDependentBeans.add(dependent 
Bean); 


} 
/* 
* 因为 bean 创 建 后 其 所 依赖 的 bean 一 定 是 已 经 创建 的 ， 
* actualDependentBeans 不 为 空 则 表示 当前 bean 创 
建 后 其 依赖 的 bean 却 没有 没 





























全 部 创建 完 ， 也 就 是 说 存在 循环 依赖 
*/ 
if (!actualDependentBeans.isEmpty()) { 
throw new BeanCurrentlyInCreationExcep 


tion(beanName, 
"Bean with name '" + beanName 
+ "' has been injected into other beans [" + 
StringUtils.collectionToCommaD 
elimitedString 


(actualDependentBeans) + 
"] in its raw version as part 


of a circular reference, 
but has eventually been " + 

"wrapped. This means that said 
other beans do not use the final version of the " + 


"bean. This is often the resul 
t of over-eager type 


matching - consider using " + 


"'getBeanNamesOfType' with the 
'allowEagerInit' flag turned off, for example."); 


} 
} 
} 
} 
// Register bean as disposable. 
try { 
// 根 据 scopse 注 册 bean 


registerDisposableBeanIfNecessary 


(beanName, bean, mbd); 
} 
catch (BeanDefinitionValidationException ex) { 
throw new BeanCreationException(mbd.getResourceDes 
cription(), beanName, "Invalid destruction signature", ex); 


return exposedObject; 








His agedum, Bie 
源码 的 时 PRE CHS 人 都 会 直接 忽略 挥 。 在 此 不 








深入 探讨 日 志 及 异 弟 的 设计 ， 我 们 看 看 整个 函数 的 
概要 思路 。 


1， 如 果 是 单 例 则 需要 首先 清除 缓存 。 





2. 实例 化 bean， 将 BeanDefinition 转 换 为 


BeanWrapper. 


转换 是 一 个 复杂 的 过 程 ， 但 是 我 们 可 以 符 试 概 
括 大 致 的 功能 ， 如 下 所 示 。 


EEUU e enn are 

。 一 个 类 有 多 个 构造 函数 ， 每 个 构造 函数 都 有 不 
同 的 参数 ， 所 以 圾 要 根据 参数 锁定 构造 函数 并 
进行 初始 化 。 

。 如 果 既 不 存在 工厂 方法 也 不 存在 带 有 参数 的 构 
Dor emm 
列 化 。 


3. MergedBeanDefinitionPostProcessorff] V 





bean 合 并 后 的 处 理 ，Autowired 注 解 正 是 通过 此 
方法 实现 诸如 类 型 的 预 解析 。 


4. 依赖 处 理 。 


在 Spring 中 会 有 循环 依赖 的 情况 ， 例 如 ， 当 A 
中 含有 B 的 属性 ， 而 B 中 又 含有 A 的 属性 时 惑 会 构成 
一 个 循环 依赖 ， 此 时 如 果 A 和 了 B 都 是 单 例 ， 那 么 在 
Spring 中 的 处 理 方式 残 是 当 创 建 B 的 时 候 ， 涉 及 自 
动 注 入 A 的 步骤 时 ， 并 不 是 直接 去 再 次 创建 A， 而 











是 通过 放 入 绥 存 中 的 ObjectFactory 来 创建 实例 ， 这 
样 束 解决 了 循环 依赖 的 问题 。 


5. 属性 十 充 。 将 所 有 属性 填充 全 bean 的 实例 


6. 循环 依赖 检查 。 


之 前 有 提 到 过 ， 在 Sping 中 解决 循环 依赖 只 对 
单 例 有 效 ， 而 对 于 prototype 的 bean，Spring 没 有 好 
的 解决 办 法 ， 唯 一 要 做 的 就 是 抛 出 异常 。 在 这 个 步 
又 里 面 会 检测 已 经 加 载 的 bean 是 否 已 经 出 现 了 依赖 
循环 ， 并 判断 是 否 需 要 抛 出 寞 第。 


7. 注册 DisposableBean。 


如 果 配 置 了 destroy-method， 这 里 需要 注册 以 
便于 在 销毁 时 候 调 用 。 

8， 完 成 创建 并 返回 。 

可 以 看 到 上 面 的 步骤 非常 的 迪 殴 ， 每 一 步骤 都 
使 用 了 大 量 的 代码 来 完成 其 功能 ， 最 复杂 也 是 最 难 
以 理解 的 当 属 循环 依赖 的 处 理 ， 在 真正 进入 
doCreateBean 前 我 们 有 必要 先 了 人 解 下 循环 依赖 。 











5.7.1 创建 bean 的 实例 


当 我 们 了 解 了 循环 依赖 以 后 就 可 以 深入 分 析 创 
建 bean 的 每 一 个 步骤 了 ， 首 先 我 们 从 


createBeanInstance 开 始 。 





protected BeanWrapper createBeanInstance(String beanName, RootB 
eanDefinition mbd, 
Object[] args) { 

// 解 析 class 

Class beanClass = resolveBeanClass(mbd, beanName); 





if (beanClass !- null && !Modifier.isPublic(beanClass. 
getModifiers()) && !mbd. 
isNonPublicAccessAllowed()) { 
throw new BeanCreationException(mbd.getResourceDes 
cription(), beanName, 
"Bean class isn't public, and non-public a 
ccess not allowed: " + beanClass.getName()); 








} 

// 如 果 工 三 方法 不 为 空 则 使 用 工厂 方法 初始 化 策略 

if (mbd.getFactoryMethodName() != null) { 
return instantiateUsingFactoryMethod 


(beanName, mbd, args); 


// Shortcut when re-creating the same bean... 
boolean resolved - false; 
boolean autowireNecessary - false; 
if (args == null) { 
synchronized (mbd.constructorArgumentLock) { 
// 一 个 类 有 多 个 构造 函数 ， 每 个 构造 函数 都 有 不 同 的 参数 ， 所 
以 调用 前 需要 先 根 据 参数 锁定 构 
// 造 函数 或 对 应 的 工厂 方法 
if (mbd.resolvedConstructorOrFactoryMethod !- 

















null) ( 
resolved - true; 
autowireNecessary - mbd.constructorArgumen 


tsResolved; 


j 


} 
// 如 果 已 经 解析 过 则 使 用 解析 好 的 构造 函数 方法 不 需要 再 次 锁定 
if (resolved) ( 
if (autowireNecessary) { 
// 构 造 函 数 自动 注入 
return autowireConstructor 

















(beanName, mbd, null, null); 
j 


else ( 
// 使 用 默认 构造 函数 构造 


return instantiateBean 





(beanName, mbd); 


j 
// 需 要 根据 参数 解析 构造 函数 


Constructor[] ctors = determineConstructorsFromBeanPos 
tProcessors(beanClass, beanName); 








if (ctors !- null || 
mbd.getResolvedAutowireMode() -- RootBeanDefin 
ition. AUTOWIRE 
CONSTRUCTOR || 
mbd.hasConstructorArgumentValues() || !ObjectU 
tils.isEmpty(args)) { 
// 构 造 函 数 自动 注入 


return autowireConstructor 


(beanName, mbd, ctors, args); 


} 
// 使 用 默认 构造 函数 构造 


return instantiateBean 





(beanName, mbd); 


j 








虽然 代码 中 实例 化 的 细节 非常 复杂 ， 但 是 在 
createBeanIntance 方 法 中 我 们 还 是 可 以 清晰 地 看 到 
实例 化 的 逻辑 的 。 


1. 如 果 在 RootBeanDefinition 中 存在 
factoryMethodName 属 性 ， 或 者 说 在 配置 文件 中 配 
置 了 factory-method， 那 么 Spring 会 尝试 使 用 
instantiateUsingFactoryMethod(beanName, mbd, args) 
方法 根据 RootBeanDefinition 中 的 配置 生成 bean 的 实 
例 。 


2， 解 析 构 造 函 数 并 进行 构造 函数 的 实例 化 。 
为 一 个 bean 对 应 的 类 中 可 能 会 有 多 个 构造 函数 ， 
而 每 个 构造 函数 的 参数 不 同 ，Spring 在 根据 参数 及 
关 型 去 判断 最 终 会 使 用 哪个 构造 函数 进行 实例 化 。 
但 是 ， 判 断 的 过 程 是 个 比较 消耗 性 能 的 步骤 ， 所 以 
采用 绥 存 机 制 ， 如 果 已 经 解析 过 则 不 需要 重复 解析 
而 是 直接 从 RootBeanDefinition 中 的 属性 
resolvedConstructorOrFactoryMethod 绥 存 的 值 去 
取 ， 人 个 则 需要 再 次 解 机， 并 将 解析 的 结 末 添加 人 至 
RootBeanDefinition 中 的 属性 
resolvedConstructorOrFactoryMethod 中 。 





1. autowireConstructor 


对 于 实例 的 创建 Spring 中 分 成 了 两 种 情况 ， 一 





MeAIB, nPE H Xm. 
UH ZU] SEB OTE SA EARS ALA FE EE AI BAR 
定性 ， 所 以 在 判断 对 应 参数 上 做 了 大 量 工作 。 





public Beanwrapper autowireConstructor( 

final String beanName, final RootBeanDefinition mb 
d, Constructor[] 
chosenCtors, final Object[] explicitArgs) { 


BeanWrapperlImpl bw = new BeanwrapperImpl(); 
this.beanFactory.initBeanWrapper (bw); 


Constructor constructorToUse - null; 
ArgumentsHolder argsHolderToUse - null; 
Object[] argsToUse - null; 
//explicitArgs 通 过 getBean 方 法 传 入 
// 如 果 getBean 方 法 调用 的 时 候 指 定 方 法 参数 那么 直接 使 用 
if (explicitArgs !- null) { 
argsToUse - explicitArgs; 
jelse ( 
// 如 果 在 getBean 方 法 时 候 没 有 指定 则 尝试 从 配置 文件 中 解析 
Object[] argsToResolve = null; 
// 党 试 从 缓存 中 获取 
synchronized (mbd.constructorArgumentLock) { 
constructorToUse - (Constructor) mbd.resolvedC 
onstructorOrFactoryMethod; 


















































if (constructorToUse !- null && mbd.constructo 
rArgumentsResolved) { 
// 从 缓存 中 取 
argsToUse = mbd.resolvedConstructorArgumen 
ts; 
if (argsToUse -- null) ( 
// 配 置 的 构造 函数 参数 
argsToResolve = mbd.preparedConstructo 
rArguments; 
} 
} 
} 
// 如 果 缓 存 中 存在 


if (argsToResolve !- null) ( 
// 解 析 参 数 类 型 ， 如 给 定 方法 的 构造 函数 A(int, int ) 则 通过 
此 方法 后 就 会 把 配置 中 的 





























//("1", "1") 转 换 为 (1,1) 

// 缓 存 中 的 值 可 能 是 原始 值 也 可 能 是 最 终 值 

argsToUse = resolvePreparedArguments(beanName, 
mbd, bw, constructorToUse, argsToResolve); 








} 
} 
// 没 有 被 缓存 
if (constructorToUse -- null) ( 
// Need to resolve the constructor. 
boolean autowiring - (chosenCtors !- null || 


mbd.getResolvedAutowireMode() == RootBeanD 
efinition.AUTOWIRE 
CONSTRUCTOR); 
ConstructorArgumentValues resolvedValues = null; 


int minNrOfArgs; 
if (explicitArgs !- null) ( 
minNrOfArgs - explicitArgs.length; 
jelse ( 
// 提 取 配 置 文件 中 的 配置 的 构造 函数 参数 
ConstructorArgumentValues cargs = mbd.getConst 
ructorArgumentValues(); 
// 用 于 承载 解析 后 的 构造 函数 参数 的 值 


resolvedValues = new ConstructorArgumentValues 





























(); 

// 能 解析 到 的 参数 个 数 

minNrOfArgs = resolveConstructorArguments(bean 
Name, mbd, bw, cargs, 
resolvedValues); 


j 





// Take specified constructors, if any. 
Constructor[] candidates - chosenCtors; 
if (candidates == null) { 
Class beanClass = mbd.getBeanClass(); 
try { 
candidates = (mbd.isNonPublicAccessAllowed 
() ? 
beanClass.getDeclaredConstructors( 
) : beanClass. 
getConstructors()); 


catch (Throwable ex) { 
throw new BeanCreationException(mbd.getRes 


ourceDescription(), beanName, 
"Resolution of declared constructo 
rs on bean Class [" + 
beanClass.getName() + 
"] from ClassLoader [" + b 
eanClass. getClassLoader() + "] failed", ex); 


} 

// 排 序 给 定 的 构造 函数 ，pub1ic 构 造 函数 优先 参数 数量 降序 、 非 pu 
bic 构 造 函 数 参数 数量 降序 

AutowireUtils.sortConstructors(candidates); 











int minTypeDiffWeight - Integer.MAX VALUE; 
Set«Constructor» ambiguousConstructors - null; 
List<Exception> causes = null; 


for (int i = 0; i < candidates.length; i++) ( 
Constructor<?> candidate = candidates[i]; 
Class[] paramTypes = candidate.getParameterTyp 
es(); 


if (constructorToUse !- null && argsToUse.leng 
th » paramTypes.length) ( 
// 如 果 已 经 找到 选用 的 构造 函数 或 者 需要 的 参数 个 数 小 于 当 
前 的 构造 函数 参数 个 数 则 终止 ， 
// 因 为 已 经 按照 参数 个 数 降序 排列 








break; 

} 

if (paramTypes.length < minNrOfArgs) ( 
// 参 数 个 数 不 相 等 
continue; 

} 


ArgumentsHolder argsHolder; 
if (resolvedValues !- null) { 
// 有 参数 则 根据 值 构造 对 应 参数 类 型 的 参数 
try { 
String[] paramNames = null; 
if (constructorPropertiesAnnotationAva 





ilable) ( 

// 注 释 上 获取 参数 名 称 

paramNames = ConstructorProperties 
Checker. evaluateAn 


notation (candidate, paramTypes.length); 


if (paramNames == null) { 
// 获 取 参 数 名 称 探索 器 
ParameterNameDiscoverer pnd = this 
.beanFactory. getParameter 
NameDiscoverer(); 
if (pnd !- null) ( 
/ [IRR E E XE PR ISB PK 


paramNames = pnd.getParameterN 





ames(candidate) ; 


J 
} 
// 根 据 名 称 和 数据 类 型 创建 参数 持 有 者 


argsHolder = createArgumentArray( 
beanName, mbd, resolvedValues, 











bw, paramTypes, 
paramNames, candidate, autowiring); 


catch (UnsatisfiedDependencyException ex) 


t 
if (this.beanFactory.logger.isTraceEna 
bled()) { 
this.beanFactory.logger.trace( 
"Ignoring constructor [" + 
candidate + "] of bean '" + beanName + "': " + ex); 


if (i -- candidates.length - 1 && cons 
tructorToUse -- null) ( 
if (causes !- null) ( 
for (Exception cause : causes) 
{ 
this.beanFactory.onSuppres 
sedException(cause); 


} 
} 
throw ex; 
} 
else ( 
// Swallow and try next constructo 
r. 
if (causes == null) { 
causes = new LinkedList<Except 
ion>(); 


causes.add(ex); 


continue; 


} 
}else { 


if (paramTypes.length !- explicitArgs.leng 
th) { 


continue; 


j 
// 构 造 函数 没有 参数 的 情况 


argsHolder = new ArgumentsHolder(explicitA 








rgs); 
j 


// 探 测 是 否 有 不 而 








定性 的 构造 函数 存在 ， 例 如 不 同 构造 函数 的 








ap 








参数 为 父子 关系 
int typeDiffWeight = (mbd.isLenientConstructor 
Resolution() ? 
argsHolder.getTypeDifferenceWeight(par 
amTypes) : argsHolder. getAssignabilityWeight(paramTypes)); 
// 如 果 它 代表 着 当前 最 接近 的 匹配 则 选择 作为 构造 函数 
if (typeDiffWeight < minTypeDiffWeight) { 
constructorToUse - candidate; 
argsHolderToUse - argsHolder; 
argsToUse - argsHolder.arguments; 
minTypeDiffWeight - typeDiffWeight; 
ambiguousConstructors - null; 
jelse if (constructorToUse !- null && typeDiff 
Weight == minTypeDiffWeight) { 
if (ambiguousConstructors == null) { 
ambiguousConstructors - new LinkedHash 




















Set<Constructor>(); 
ambiguousConstructors.add(constructorT 


oUse); 
} 
ambiguousConstructors.add(candidate); 
} 
} 
if (constructorToUse == null) { 


throw new BeanCreationException(mbd.getResourc 
eDescription(), beanName, 
"Could not resolve matching constructo 
r " + 
"(hint: specify index/type/name argume 


nts for simple 
parameters to avoid type ambiguities)"); 
jelse if (ambiguousConstructors !- null && !mbd.is 
LenientConstructor Resolution()) { 
throw new BeanCreationException(mbd.getResourc 
eDescription(), beanName, 
"Ambiguous constructor matches found i 
n bean '" + beanName + "' " + 
"(hint: specify index/type/name argume 
nts for simple 
parameters to avoid type ambiguities): " + 
ambiguousConstructors); 


j 


if (explicitArgs == null) { 
// 将 解析 的 构造 函数 加 入 缓存 


argsHolderToUse.storeCache(mbd, constructorToU 





se); 


try { 
Object beanInstance; 


if (System.getSecurityManager() !- null) { 
final Constructor ctorToUse - constructorToUse 


final Object[] argumentsToUse - argsToUse; 
beanInstance - AccessController.doPrivileged(n 
ew PrivilegedAction< Object>() { 
public Object run() { 
return beanFactory.getInstantiationStr 
ategy().instantiate( 
mbd, beanName, beanFactory, ct 
orToUse, argumentsToUse); 


}, beanFactory.getAccessControlContext()); 
} 
else { 
beanInstance = this.beanFactory.getInstantiati 
onStrategy( ).instantiate( 
mbd, beanName, this.beanFactory, const 
ructorToUse, argsToUse); 


} 
// 将 构建 的 实例 加 入 Beanwrapper 中 





bw.setWrappedInstance(beanInstance); 
return bw; 


catch (Throwable ex) { 


throw new BeanCreationException(mbd.getResourceDes 
cription(), beanName, "Instantiation of bean failed", ex); 


j 





逻辑 很 复 洒 ， 函 数 代 码 量 很 大 ， 不 知道 你 是 否 
坚持 读 完 了 整个 函数 并 理解 了 整个 功能 呢 ? 这 里 要 
先 吐 个 述 ， 作 者 觉得 这 个 函数 的 写法 完全 不 符合 





Spring 的 一 贯 风 格 ， 如 果 你 一 直 跟 随 作 者 的 分 析 思 
路 到 这 里 ， 相 信 你 或 多 或 少 对 Spring 的 编码 风格 有 
所 了 解 ，Spring 的 一 贯 做 法 是 将 复杂 的 逻辑 分 解 ， 
分 成 N 个 小 函数 的 租 套 ， 每 一 层 都 是 对 下 一 层 迎 辑 
的 总 结 及 概要 ， 这 样 使 得 每 一 层 的 逻辑 会 变 得 人 简单 
容易 理解 。 在 上 面 的 函数 中 ， 包 含 痢 很 多 的 逻辑 实 
现 ， 作 者 党 得 至 少 应 该 将 馆 辑 封装 在 不 同 函 数 中 而 
使 得 在 autowireConstructor 中 的 逻辑 清晰 明了 。 








我 们 总 哎 一 下 整个 函数 ， 其 实现 的 功能 考虑 了 
以 下 几 个 方面 。 


1. 构造 函 数 参数 的 确定 。 


。 根 据 explicitArgs 参 数 判断 。 


如 果 传 入 的 参数 explicitArgs 不 为 衬 ， 那 边 可 以 
直接 确定 参数 ， 因 为 explicitArgs 人 参数 是 在 调用 Bean 
的 时 候 用 户 指定 的 ， 在 BeanFactory 类 中 存在 这 样 的 
方法 : 








Object getBean(String name, Object... args) throws BeansExcepti 
on; 





在 获取 bean 的 时 候 ， 用 户 不 但 可 以 指定 bean 的 
名 称 还 可 以 指定 bean 所 对 应 类 的 构造 疯 数 或 者 工厂 
方法 的 方法 参数 ， 主 要 用 于 静态 工厂 方法 的 调用 ， 
而 这 里 是 需要 给 定 完 全 匹配 的 参数 的 ， 所 以 ， 便 可 
以 判断 ， 如 果 传 入 参数 explicitArgs 不 为 衬 ， 则 可 以 
确定 构造 函数 参数 就 是 它 。 


。 绥 存 中 获取 。 


除 此 之 外 ， 确 定 参数 的 办 法 如 条 之 前 已 经 分 析 
过 ， 也 就 是 说 构造 函数 参数 已 经 记录 在 缓存 中 ， 那 
么 便 可 以 直接 拿 来 使 用 。 而 且 ， 这 里 要 提 到 的 是 ， 
在 缓存 中 缓存 的 可 能 是 参数 的 最 终 关 型 也 可 能 是 参 
数 的 初始 类 型 ， 例 如 ; 构造 函数 参数 要 求 的 是 int 类 
型 ， 但 是 原始 的 参数 值 可 能 是 String 类 型 的 “1”， 那 
么 即使 在 缓存 中 得 到 了 参数 ， 也 需要 经 过 类 型 转换 
途 的 过 小 以 确保 参数 类 型 与 对 应 的 构造 函数 参数 类 
型 完全 对 应 。 




















。 配 置 文件 获取 。 


如 果 不 能 根据 传 入 的 参数 explicitArgs 人 确定 构造 
函数 的 参数 也 无 法 在 缓存 中 得 到 相关 信息 ， 那 么 只 
能 开始 新 一 轮 的 分 析 了 。 


分 析 从 获取 配置 文件 中 配置 的 构造 函数 信息 开 
始 ， 经 过 之 前 的 分 析 ， 我 们 知道 ，Spring 中 配置 文 
件 中 的 信息 经 过 转换 都 会 通过 BeanDefinition 实 例 承 
载 ， 也 残 是 参数 mbd 中 包含 ， 那 么 可 以 通过 调用 
mbd.getConstructorArgumentValues() 来 获取 配置 的 
构造 函数 信息 。 有 了 配置 中 的 信息 便 可 以 获取 对 应 
的 参数 值 信 息 了 ， 获 取 参 数值 的 信息 包括 直接 指定 
值 ， 如 : 直接 指定 构造 函数 中 某 个 值 为 原始 类 型 
String 类 型 ， 或 者 是 一 个 对 其 他 bean 的 引用 ， 而 这 
一 处 理 委 托 给 resolveConstructorArguments 方 法 ， 并 
返回 能 解析 到 的 参数 的 个 数 。 


2. FAE PK Z HIHA JE o 


AN SH a CAME SMe RAA, 
接 下 来 的 任务 就 是 根据 构造 函数 参数 在 所 有 构造 函 
数 中 锁定 对 应 的 构造 沙 数 ， 而 匹配 的 方法 束 是 根据 
参数 个 数 匹 配 ， 所 以 在 匹配 之 前 需要 先 对 构造 函数 
按照 public 构 造 函 数 优 多 参数 数量 降序 、 非 public 构 
造 图 数 参 数 数量 降序 。 这 样 可 以 在 遍历 的 情况 下 迅 


























速 判断 排 在 后 面 的 构造 函数 参数 个 数 是 否 符合 条 


由 于 在 配置 文件 中 并 不 是 唯一 限制 使 用 参数 位 
置 索 引 的 方式 去 创建 ， 同 样 还 文 持 指定 参数 名 称 进 
行 设 定 参 数值 的 情况 ， 如 <constructor-arg 
name="aa">， 那 么 这 种 情况 束 害 要 上 自 先 确定 构造 浮 
数 中 的 参数 名 称 。 


获取 参数 名 称 可 以 有 两 种 方式 ， 一 种 是 通过 注 
解 的 方式 直接 获取 ， 男 一 种 就 是 使 用 Spring 中 提供 
的 工具 类 ParameterNameDiscoverer 来 获取 。 构 造 函 
数 、 参 数 名 称 、 参 数 类 型 、 参 数值 都 确定 后 就 可 以 
锁定 构造 函数 以 及 转换 对 应 的 参数 类 型 了 。 


3， 根 据 确定 的 构造 函数 转换 对 应 的 参数 类 
型 

















主要 是 使 用 Spring 中 提供 的 类 型 转换 占 或 者 用 
尸 提供 的 目 定 义 类 型 转换 器 进行 转换 。 


4. 构造 函数 不 确定 性 的 验证 。 


当然 ， 有 时 候 即 使 构 寺 函数、 参数 名 称 、 参 数 
类 型 、 参 数值 部 确定 后 也 不 一 定 会 直接 锁定 构造 隙 
数 ， 不 同 构 造 函 数 的 参数 为 父子 关系 ， 所 以 Spring 
在 最 后 又 做 了 一 次 验证 。 





5. 根据 实例 化 策略 以 及 得 到 的 构造 函数 及 构 
造 函 数 参 数 实例 化 Bean。 后 面 章 节 中 将 进行 讲解 。 





2. instantiateBean 





经 历 了 帝 有 参数 的 构造 水 数 的 实例 构造 ， 相 信 
你 会 非常 轻松 愉快 地 理解 不 带 参 数 的 构造 函 7 的 实 
例 化 过 程 。 





protected BeanWrapper instantiateBean(final String beanNam 
e, final RootBean 
Definition mbd) { 
try { 
Object beanInstance; 
final BeanFactory parent - this; 
if (System.getSecurityManager() !- null) { 
beanInstance - AccessController.doPrivileged(n 
ew PrivilegedAction 
<Object>() { 
public Object run() { 
return getInstantiationStrategy().inst 
antiate(mbd, beanName, parent); 


}, getAccessControlContext()); 


else { 
beanInstance = getInstantiationStrategy().inst 
antiate(mbd, beanName, parent); 


} 


BeanWrapper bw = new BeanWrapperImp1(beanInstance) 


initBeanWrapper (bw); 
return bw; 


catch (Throwable ex) { 
throw new BeanCreationException(mbd.getResourceDes 
cription(), beanName, "Instantiation of bean failed", ex); 


你 会 及 现 ， 此 方法 并 没有 什么 实质 性 的 逻辑 ， 
带 有 参数 的 实例 构造 中 ，Spring 把 精力 都 放 在 了 构 
造 函 数 以 及 参数 的 匹配 上 ， 所 以 如 果 没 有 参数 的 话 
那 将 是 非常 简单 的 一 件 事 ， 直 接 调 用 实例 化 梨 略 进 
行 实例 化 就 可 以 了 。 





3. SCALES 


mU EE ELE 上 略 ， 那 这 
是 做 什么 用 的 呢 ? 其 实 ， 经 过 前 面 的 分 析 ， 
经 得 到 了 足以 实例 化 的 所 有 相关 信 HA. Fee By DA 
用 最 简单 的 反射 方法 直接 反射 来 构造 实例 对 象 ， 但 
是 Spring 却 并 没有 这 人 么 做 。 











SimpleInstantiationStrategy.java 





public Object instantiate(RootBeanDefinition beanDefinition, St 
ring beanName, 
BeanFactory owner) { 

















// 如 果 有 需要 履 盖 或 者 动态 蔡 换 的 方法 则 当然 需要 使 用 cgLib 进 行动 态 代 
里 ， 因 为 可 以 在 创建 代理 的 同时 
// 将 动态 方法 织 入 类 中 
// 但 是 如 果 没 有 需要 动态 改变 得 方法 ， 为 了 方便 直接 反射 就 可 以 了 
if (beanDefinition.getMethodOverrides().isEmpty()) { 
Constructor«?» constructorToUse; 
synchronized (beanDefinition.constructorArgumentLo 


























is 






































ck) 1 


constructorToUse = (Constructor<?>)beanDefinit 
ion.resolvedConstructor 
OrFactoryMethod; 


if (constructorToUse -- null) ( 
final Class clazz - beanDefinition.getBean 
Class(); 
if (clazz.isInterface()) { 
throw new BeanInstantiationException(c 
lazz, "Specified class is an interface"); 
} 
try { 
if (System.getSecurityManager() != nul 
ly 
constructorToUse - AccessControlle 
r.doPrivileged(new 
PrivilegedExceptionAction<Constructor>() { 
public Constructor run() throw 
s Exception { 
return clazz.getDeclaredCo 
nstructor((Class[]) null); 
} 
3); 
} 


else ( 
constructorToUse - clazz.getDeclar 
edConstructor((Class[]) null); 


beanDefinition.resolvedConstructorOrFa 
ctoryMethod - constructorToUse; 
} 
catch (Exception ex) { 
throw new BeanInstantiationException(c 
lazz, "No default 
constructor found", ex); 
} 
} 
} 


return BeanUtils.instantiateClass(constructorToUse 


jelse { 
// Must generate CGLIB subclass. 
return instantiateWithMethodInjection 


(beanDefinition, beanName, owner); 


j 


CglibSubclassingInstantiationStrategy.java 


public Object instantiate(Constructor ctor, Object[] args) { 
Enhancer enhancer - new Enhancer(); 
enhancer.setSuperclass(this.beanDefinition.getBean 


Class()); 
enhancer.setCallbackFilter(new CallbackFilterimpl( 
)); 
enhancer.setCallbacks(new Callback[] { 
NoOp. INSTANCE, 
new LookupOverrideMethodInterceptor(), 
new ReplaceOverrideMethodInterceptor() 
3); 
return (ctor -- null) ? 
enhancer.create() : 
enhancer.create(ctor.getParameterTypes(), 
args); 
} 











看 了 了 上面 两 个 函数 后 似乎 我 们 已 经 感受 到 了 





Spring 的 展 震 用心 以 及 为 了 能 更 方便 地 使 用 Spring 
而 做 了 大 量 的 工作 。 程 序 中 ， 首 先 判 断 如 果 
beanDefinition.getMethodOverrides() Ne th. i Hj ^ 
没有 使 用 replace 或 者 lookup 的 配置 方法 ， 那 么 直接 
使 用 反射 的 方式 ， 人 简单 快 邱 ， 但 是 如 果 使 用 了 这 两 
个 特性 ， 在 直接 使 用 反射 的 方式 创建 实例 残 不 习 
了 ， 因 为 需要 将 这 两 个 配置 提供 的 功能 切入 进去 ， 
所 以 就 必须 要 使 用 动态 代理 的 方式 将 包含 两 个 特性 
所 对 应 的 逻辑 的 拦截 增强 器 设置 进去 ， 这 样 才 可 以 
保证 在 调用 方法 的 时 候 会 被 相应 的 迫 惟 器 增强 ， 返 
回 值 为 包含 拦截 器 的 代理 实例 。 











对 于 拦截 器 的 处 理 方法 非常 简单 ， 不 再 详细 介 
绍 ， 如 果 读 者 有 兴趣 ， 可 以 仔细 研读 第 7 章 中 关于 
AOP 的 介绍 ， 对 动态 代理 方面 的 知识 会 有 更 详细 地 


介绍 。 


-— 





5.7.2 ”记录 创建 bean 的 ObjectFactory 


在 doCreate 函 数 中 有 这 样 一 段 代码 : 





boolean earlySingletonExposure 


= (mbd.isSingleton() && this.allowCircularReferences && 

isSingletonCurrentlyInCreation(beanName)); 

if (earlySingletonExposure) { 
if (logger.isDebugEnabled()) { 

logger .debug("Eagerly caching bean '" + beanNa 

me + 
"' to allow for resolving potential ci 

rcular references"); 


} 
// 为 避免 后 期 循环 依赖 ， 可 以 在 bean 初 始 化 完成 前 将 创建 实例 的 0bj 


ectFactory 加 入 工厂 
addSingletonFactory(beanName, new ObjectFactory() 
i 


nt 





public Object getObject() throws BeansExceptio 


// 对 bean 再 一 次 依赖 引用 ， 主 要 应 用 SmartInstantiat 
ionAware BeanPost Processor, 

// 其 中 我 们 熟知 的 AOP 就 是 在 这 里 将 advice 动 态 织 入 bea 
n 中 ， 若 没有 则 直接 返回 























//bean， 不 做 任何 处 理 
return getEarlyBeanReference(beanName, mbd 








, bean); 


J): 


MEM 


这 段 代 码 不 是 很 复杂 ， 但 大 很 多 人 不 是 太 理 解 
这 上 段 代 码 的 作用 ， 而 且 ， 这 上 段 代码 仪 从 此 函数 中 去 
理解 也 很 难 弄 异 其 中 的 含义 ， 我 们 需要 从 全 局 的 角 
EE HE Spring HY AO e DJ NÉE -o 


earlySingletonExposure: M FE HY) xs E PEEL Ae 
提早 曝光 的 单 例 ， 我 们 暂 不 定义 它 的 学 名 叫 什 
么 ， 我 们 感 兴 趣 的 是 有 哪些 条 件 影响 这 个 值 。 
mbd.isSingleton(): 没有 太 多 可 以 解释 的 ， 此 
RootBeanDefinition 代 表 的 — 是 单 例 。 
this.allowCircularReferences: 是 人 否 允 许 循 环 依 
Ril, ARTA, 并 没有 找到 在 配置 文件 中 如 何 配 
置 ， 但 是 在 
AbstractRefreshableApplicationContext 中 提供 了 
设置 函数 ， 可 以 通过 便 编 但 的 方式 进行 设置 或 
者 可 以 通过 目 定 义 命名 空间 进行 配置 ， 其 中 硬 
编码 的 方式 代码 如 下 。 

















ClassPathXmlApplicationContext bf = new ClassPathXmlApplic 
ationContext ("aspectTest.xml"); 


bf.setAllowBeanDefinitionOverriding(false); 





pon cu ui i ea on oan aM 1% 
bean 是 否 在 创建 中 。 在 Spring 中 ， 会 有 个 专门 的 
属性 默认 为 DefaultSingletonBeanRegistry 的 


singletonsCurrentlyInCreation?K id 3& bean f JT V, 
状态 ， 在 bean 开 始 创建 前 会 将 beanName 记 录 在 
属性 中 ， 在 bean 创 建 结束 后 会 将 beanName 从 属 
性 中 移 除 。 那 么 我 们 跟随 代码 一 路 走 来 可 是 对 
这 个 属性 的 记录 并 没有 多 少 印象 ， 这 个 状态 是 
在 哪里 记录 的 昵 ? 不 同 scope 的 记录 位 置 并 不 一 
样 ， 我 们 以 singleton 为 例 ， fEsingleton 下 记录 属 
性 的 函数 是 在 DefaultSingletonBeanRegistry 类 的 
public Object getSingleton(String beanName, 
ObjectFactory singletonFactory) K 2H) 
beforeSingletonCreation(beanName) fll 
i a a 中 ， 在 这 两 段 
图 数 中 分 别 
this.singletonsCurrentlyInCreation.add(beanName) 
5jthis.singletonsCurrentlyIn- 
Creation.remove(beanName) 来 进行 状态 的 记录 与 
移 除 。 


经 过 以 上 分 析 我 们 了 解 变 量 
earlySingletonExposure 是 侣 是 单 例 、 是 否 人 允许 循 环 
依赖 、 是 否 对 a 的 综合 。 当 
这 3 个 条 件 都 满足 时 会 执行 addSingletonFactory#& 
作 ， 那 么 加 入 SingletonFactory 的 作用 是 什么 昵 ? 又 
是 在 什么 时 候 调 用 呢 ? 








我 们 还 是 以 简单 的 AB 循 环 依赖 为 例 ， 关 A 中 合 


有 属性 类 B， 而 类 B 中 又 会 含有 属性 类 A， 那 么 初始 
化 beanA 的 过 程 如 图 5-3 所 示 。 


开始 创建 bean( 记 录 beanNameA) 


addsingletonFacto ry 


populateB ean 填充 属性 ) » 开始 创建 bean( 记 录 beanNameB) 


| tii ben bb ben aed) | 

































addSin acto 
* 
populateB ean( 填 充 属性 ) 








结束 创建 bean( 移 除 beanNameB) 





图 5-3 ”处 理 循环 依赖 


图 5-3 中 展示 了 创建 bean 人 A 的 流程 ， 图 中 我 们 看 
到 ， 在 创建 A 的 时 候 首 先 会 记录 类 A 所 对 应 的 
beanName， 并 将 beanA 的 创建 工厂 加 入 绥 存 中 ， 而 
在 对 A 的 属性 填充 也 就 是 调用 populate 方 法 的 时 候 叉 
会 再 一 次 的 对 B 进 行 递 归 创 建 。 同 样 的 ， 因 为 在 B 
中 同样 存在 A 属性 ， 因 此 在 实例 化 B 的 的 populate 方 
法 中 又 会 再 次 地 初始 化 B， 也 束 是 网 形 的 最 后 ， 调 
用 getBean(A)。 关 键 是 在 这 里 ， 有 心 的 同学 可 以 去 
找 找 这 个 代码 的 实现 方式 ， 我 们 之 前 已 经 讲 过 ， 在 
这 个 函数 中 并 不 是 直接 去 实例 化 A， 而 是 先 去 检测 
绥 存 中 是 否 有 已 经 创建 好 的 对 应 的 bean， 或 者 是 人 否 
已 经 创建 好 的 ObjectFactory， 而 此 时 对 于 A 的 

















ObjectFactory 我 们 早已 经 创建 ， 所 以 便 不 会 再 去 问 
后 执行 ， 而 是 直接 调用 ObjectFactory 去 创建 A。 这 
里 最 关键 的 是 ObjectFactory 的 实现 。 








addSingletonFactory(beanName, new ObjectFactory() ( 
public Object getObject() throws BeansExceptio 


n { 
// 对 bean 再 一 次 依赖 引用 ， 主 要 应 用 SmartInstantiat 
ionAware BeanPost Processor， 
// 其 中 我 们 熟知 的 AOP 就 是 在 这 里 将 advice 动 态 织 入 bea 








nF, FRA NAR El 

















//bean， 不 做 任何 处 理 
return getEarlyBeanReference 








(beanName, mbd, bean); 


J): 





其 中 getEarlyBeanReference 的 代码 如 下 : 





protected Object getEarlyBeanReference(String beanName, RootBea 
nDefinition mbd, Object bean) { 

Object exposedObject - bean; 

if (bean != null && !mbd.isSynthetic() && hasInstantia 
tionAwareBeanPostProcessors 


O0) 1 
3E. 


for (BeanPostProcessor bp : getBeanPostProcessors( 


if (bp instanceof SmartInstantiationAwareBeanP 
ostProcessor) ( 
SmartInstantiationAwareBeanPostProcessor i 
bp - 
(SmartInstantiationAwareBeanPostProcessor) bp; 
exposedObject - ibp.getEarlyBeanReference( 
exposedObject, beanName); 
if (exposedObject -- null) ( 
return exposedObject; 


j 


j 
j 


} 
return exposedObject; 


fEgetEarlyBeanReferencerK HIF AAS HY 
逻辑 处 理 ， 或 者 说 除了 后 处 理 器 的 调用 外 没有 别 的 
处 理工 作 ， 根 据 以 上 分 析 ， 基 本 可 以 理 清 Spring 处 
理 循环 依赖 的 解决 办 法 ， 在 B 中 创建 依赖 A 时 通过 
ObjectFactory 提 供 的 实例 化 方法 来 中 断 A 中 的 属性 
填充 ， 使 B 中 持 有 的 A 仅 仅 是 刚刚 初始 化 并 没有 项 
充任 何 属性 的 A， 而 这 正 初 始 化 A 的 步 又 还 是 在 最 
开始 创建 A 的 时 候 进 行 的 ， 但 是 因为 A 与 B 中 的 A 所 
表示 的 属性 地 址 是 一 样 的 ， 所 以 在 A 中 创建 好 的 属 
性 填充 目 然 可 以 通过 B 中 的 A 获取 ， 这 样 就 解决 了 
循环 依赖 的 问题 。 


5.7.3 ”属性 注入 


在 了 解 循 坏 依赖 的 时 候 ， 我 们 曾经 反复 提 到 了 
populateBean 这 个 函数 ， 也 多 少 了 解 了 这 个 函数 的 
主要 功能 就 是 属性 填充 ， 那 么 究竟 是 如 何 实现 填 元 
的 呢 ? 








protected void populateBean(String beanName, AbstractBeanDefini 
tion mbd, BeanWrapper bw) { 
PropertyValues pvs - mbd.getPropertyValues(); 


if (bw -- null) ( 
if (!pvs.isEmpty()) { 
throw new BeanCreationException( 
mbd.getResourceDescription(), beanName 
, "Cannot apply property values to null instance"); 








} 

else ( 
// 没 有 可 填充 的 属性 
return; 

} 





M 
HE 


// 给 InstantiationAwareBeanPostProcessors 最 后 一 次 机 会 在 届 
设置 前 来 改变 bean 
// 如 : 可 以 用 来 支持 属性 注入 的 类 型 


boolean continueWithPropertyPopulation = true; 








if (!mbd.isSynthetic() && hasInstantiationAwareBeanPos 
tProcessors()) ( 
for (BeanPostProcessor bp : getBeanPostProcessors( 


)) t 
if (bp instanceof InstantiationAwareBeanPostPr 
ocessor) ( 


InstantiationAwareBeanPostProcessor ibp - 


(InstantiationAwareBean PostProcessor) bp; 
// 返 回 值 为 是 否 继续 填充 bean 
if (!ibp.postProcessAfterInstantiation(bw. 
getWwrappedInstance(), 
beanName)) { 
continueWithPropertyPopulation - false 


break; 


d 


} 

// 如 果 后 处 理 器 发 出 停止 填充 命令 则 终止 后 续 的 执行 

if (!continueWithPropertyPopulation) { 
return; 




















j 


if (mbd.getResolvedAutowireMode() -- RootBeanDefinitio 


n.AUTOWIRE BY NAME || 
mbd.getResolvedAutowireMode() -- RootBeanDefin 
ition.AUTOWIRE BY TYPE) ( 
MutablePropertyValues newPvs - new MutableProperty 
Values(pvs); 


// Add property values based on autowire by name i 
f applicable. 
// 根 据 名 称 自动 注入 
if (mbd.getResolvedAutowireMode() == RootBeanDefin 
ition.AUTOWIRE BY NAME) { 
autowireByName 


(beanName, mbd, bw, newPvs); 


j 


// Add property values based on autowire by type i 
f applicable. 
// 根 据 类 型 自动 注入 
if (mbd.getResolvedAutowireMode() == RootBeanDefin 
ition.AUTOWIRE BY TYPE) ( 
autowireByType 


(beanName, mbd, bw, newPvs); 


j 


pvs - newPvs; 


J 


// 后 处 理 器 已 经 初始 化 

boolean hasInstAwareBpps = hasInstantiationAwareBeanPo 
stProcessors(); 

// 需 要 依赖 检查 

boolean needsDepCheck = (mbd.getDependencyCheck() != R 
ootBeanDefinition. 
DEPENDENCY CHECK NONE); 























if (hasInstAwareBpps || needsDepCheck) { 
PropertyDescriptor[] filteredPds - filterPropertyD 
escriptors ForDependency Check(bw); 
if (hasInstAwareBpps) { 
for (BeanPostProcessor bp : getBeanPostProcess 
ors()) { 
if (bp instanceof InstantiationAwareBeanPo 
stProcessor) ( 


InstantiationAwareBeanPostProcessor ib 
p = (InstantiationAwareBean PostProcessor) bp; 

// 对 所 有 需要 依赖 检查 的 属性 进行 后 处 理 

pvs = ibp.postProcessPropertyValues(pv 



































s, filteredPds, bw. 
getWwrappedlInstance(), beanName); 
if (pvs -- null) ( 
return; 
} 


} 


if (needsDepCheck) { 
// 依 赖 检 查 ， 对 应 depends -on 属性 ，3 ,0 己 经 弃 用 此 属性 
checkDependencies(beanName, mbd, filteredPds, 











pvs); 


j 


} 
// 将 属性 应 用 到 bean 中 
applyPropertyValues 





(beanName, mbd, bw, pvs); 


} 





在 populateBean 函 数 中 提供 了 这 样 的 处 理 沉 


1. InstantiationAwareBeanPostProcessor Ab FE #4% 
HJpostProcessA fterInstantiation K 20H | Hd, IE eR Ba 
可 以 控制 程序 是 否 继 续 进 行 属性 填充 。 


2. 根据 注入 类 型 (byName/byType) ， 提 取 依 
赖 的 bean， 并 统一 存 入 PropertyValues 中 。 


3. )¥ 4 InstantiationAwareBeanPostProcessorXh 
理 器 的 postProcessPropertyValues 方 法 ， 对 属性 获取 
完毕 填充 前 对 属性 的 再 次 处 理 ， 典 型 应 用 是 
RequiredAnnotationBeanPostProcessor 类 中 对 属性 的 
验证 。 


4. 将 所 有 PropertyValues 中 的 属性 填充 至 
BeanWrapper 中 。 


在 上 面 的 步 又 中 有 几 个 地 方 是 我 们 比较 感 兴趣 
的 ， 它 们 分 列 古 依赖 注入 (autowire- 
ByName/autowireByType) 以 及 属性 填充 ， 那 么 ， 
接 下 来 进一步 分 析 这 几 个 功能 的 实现 细 市 。 








1. autowireByName 


上 文 提 到 根据 注入 类 型 (byName/byType) , 
提取 依赖 的 bean， 并 统一 存 入 PropertyValues 中 ， 那 
么 我 们 首先 了 解 下 byName 功 能 是 如 何 实现 的 。 








protected void autowireByName( 
String beanName, AbstractBeanDefinition mbd, BeanW 
rapper bw, MutableProperty Values pvs) ( 





// 寻 找 bw 中 需要 依赖 注入 的 属 ! 
String[] propertyNames = unsatisfiedNonSimplePropertie 
s(mbd, bw); 
for (String propertyName : propertyNames) { 
if (containsBean(propertyName)) { 
// 递 归 初 始 化 相关 的 bean 


HE 





Object bean - getBean 


(propertyName); 
pvs.add(propertyName, bean); 
// 注 册 依 赖 
registerDependentBean(propertyName, beanName); 
if (logger.isDebugEnabled()) { 
logger.debug("Added autowiring by name fro 
m bean name '" + beanName + 
' via property '" + propertyName 
+ "' to bean named '" + propertyName + "'"); 
} 
else ( 
if (logger.isTraceEnabled()) { 
logger.trace("Not autowiring property '" + 
propertyName + "' of 
bean '" + beanName + 
' by name: no matching bean found 
"); 
} 
} 
} 
} 





如 果 读 者 之 前 了 解 了 autowire 的 使 用 方法 ， 相 
信 理 解 这 个 函数 的 功能 不 会 太 困 难 ， 无 非 是 在 传 入 
的 参数 pvs 中 找 出 已 经 加 载 的 bean， 并 递归 实例 化 ， 
进而 加 入 到 pvs 中 。 


2. autowireByType 


autowireByType 与 autowireByName 对 于 我 们 理 
解 与 使 用 来 说 复杂 程度 都 很 相似 ， 但 是 其 实现 功能 
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protected void autowireByType( 
String beanName, AbstractBeanDefinition mbd, BeanW 
rapper bw, MutableProperty Values pvs) { 


TypeConverter converter = getCustomTypeConverter(); 
if (converter == null) { 
converter = bw; 


j 


Set<String> autowiredBeanNames = new LinkedHashSet<Str 
ing>(4); 
// 寻 找 bw 中 需要 依赖 注入 的 属 ; 
String[] propertyNames = unsatisfiedNonSimplePropertie 
s(mbd, bw); 
for (String propertyName : propertyNames) { 
try { 
PropertyDescriptor pd - bw.getPropertyDescript 
or(propertyName); 
// Don't try autowiring by type for type Objec 
t: never makes sense, 
// even if it technically is a unsatisfied, no 
n-simple property. 
if (!Object.class.equals(pd.getPropertyType() ) 








HE 





) 1 





// 探 测 指定 属性 的 set 方 法 

MethodParameter methodParam = BeanUtils.ge 
tWriteMethod Parameter(pd); 

boolean eager = !PriorityOrdered.class. is 
AssignableFrom (bw.get 
WrappedClass()); 








DependencyDescriptor desc = new AutowireBy 
TypeDependencyDescriptor (methodParam, eager); 


// 解 析 指 定 peanName 的 属性 所 匹配 的 值 ， 并 把 解析 到 的 
属性 名 称 存储 在 


时 如 : 

//@Autowired private List<A> aList; 将 会 找到 
所 有 匹配 A 类 型 的 bean 并 将 

// 其 注入 

Object autowiredArgument = resolveDependen 





























//autowiredBeanNames 中 ， 当 属性 存在 多 个 封装 bean 




















cy(desc, beanName, 


autowiredBeanNames, converter); 
if (autowiredArgument !- null) ( 
pvs.add(propertyName, autowiredArgumen 


t); 
for (String autowiredBeanName : autowiredB 


eanNames) ( 
// 注 册 依 赖 
registerDependentBean(autowiredBeanNam 
e, beanName); 
if (logger.isDebugEnabled()) { 
logger .debug( "Autowiring by type f 


rom bean name '" + 
beanName + "' via property '" + 
propertyName + "' to bean 
named '" + 
autowiredBeanName + "'"); 
} 
} 
autowiredBeanNames.clear(); 
} 


catch (BeansException ex) { 
throw new UnsatisfiedDependencyException(mbd.g 
etResourceDescription(), 
beanName, propertyName, ex); 


j 
j 
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再 要 依赖 注入 的 属性 ， 同 样 对 于 根据 类 型 目 动 匹配 
的 实现 来 讲 第 一 步 也 是 寻找 bw 中 需要 依赖 注入 的 属 
性 ， 然 后 遇 历 这 些 属 性 并 寻找 类 型 匹配 的 pean， 其 
中 最 复 淋 的 束 是 寻找 类 型 匹配 的 bean。 同 时 ， 
Spring 中 近 供 了 对 集合 的 类 型 注入 的 文 持 ， 如 使 用 
注解 的 方 却 : 








@Autowired 
private List<Test> tests; 


Spring 将 会 把 所 有 与 Test 匹 配 的 类 型 找 出 来 并 
注入 到 tests 属 性 中 ， 正 是 由 于 这 一 因素 ， 所 以 在 
autowireByTyperK 2X rH, rie J Jey abi p 
autowiredBeanNames， 用 于 存储 所 有 依赖 的 bean， 
如 果 只 是 对 非 集合 类 的 属性 注入 来 说 ， 此 属性 并 无 
用 处 。 


对 于 寻找 类 型 岂 配 的 逻辑 实现 封装 在 了 
resolveDependency FK Zi FF « 














DefaultListableBeanFactory.java 





public Object resolveDependency(DependencyDescriptor descriptor 
, String beanName, 

Set«String» autowiredBeanNames, TypeConverter type 
Converter) throws BeansException { 


descriptor.initParameterNameDiscovery(getParameterName 
Discoverer()); 
if (descriptor.getDependencyType( ).equals(ObjectFactor 
y.class)) ( 
//0bjectFactory 类 注入 的 特殊 处 理 
return new DependencyObjectFactory(descriptor, bea 























nName); 


else if (descriptor.getDependencyType().equals(javaxIn 
jectProviderClass)) ( 
//javaxInjectProviderclass 类 注入 的 特殊 处 理 
return new DependencyProviderFactory().createDepen 
dencyProvider (descriptor, beanName); 


j 


else ( 






































// 通 用 处 理 逻 辑 


return doResolveDependency 














(descriptor, descriptor.getDependencyType(), 

beanName, autowiredBeanNames, typeConverter); 
} 

} 


protected Object doResolveDependency(DependencyDescriptor descr 
iptor, Class<?> type, 
String beanName, 

Set<String> autowiredBeanNames, TypeConverter type 
Converter) throws BeansException { 


/* 








* 用 于 支持 Spring 中 新 增 的 注解 6QValue 
iu 
Object value - getAutowireCandidateResolver().getSugge 
stedValue(descriptor); 
if (value !- null) { 
if (value instanceof String) { 
String strVal - resolveEmbeddedValue((String) 
value); 
BeanDefinition bd - (beanName !- null && conta 
insBean(beanName) ? getMergedBeanDefinition(beanName) : null); 
value - evaluateBeanDefinitionString(strVal, b 


d); 
} 
TypeConverter converter = (typeConverter != null ? 
typeConverter 


getTypeConverter()); 
return converter.convertIfNecessary(value, type); 


j 


// 如 果 解 析 器 没有 成 功 解析 ， 则 需要 考虑 各 种 情况 
// 属 性 是 数组 类 型 
if (type.isArray()) { 




















Class<?> componentType = type.getComponentType(); 

// 根 据 属 性 类 型 找到 beanFacotry 中 所 有 类 型 的 匹配 bean， 

// 返 回 值 的 构成 为 :key= 匹 配 的 beanName, value=beanName 对 应 
的 实例 化 后 的 bean (通过 

//getBean(beanName) 返 回 ) 

Map<String, Object> matchingBeans = findAutowireCa 
ndidates(beanName, 
































componentType, descriptor); 
if (matchingBeans.isEmpty()) { 
// 如 果 autowire 的 require 属 性 为 true 而 找到 的 匹配 项 却 为 
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if (descriptor.isRequired()) { 
raiseNoSuchBeanDefinitionException(compone 
ntType, "array of " + 
componentType.getName(), descriptor); 


return null; 


if (autowiredBeanNames !- null) { 
autowiredBeanNames.addAll(matchingBeans.keySet 


0); 


TypeConverter converter - (typeConverter !- null ? 
typeConverter 
getTypeConverter()); 
// 通 过 转换 器 将 bean 的 值 转换 为 对 应 的 type 类 型 
return converter.convertIfNecessary(matchingBeans. 
values(), type); 


// 属 性 是 Collection 类 型 
else if (Collection.class.isAssignableFrom(type) && ty 
pe.isInterface()) (1 
Class<?> elementType = descriptor.getCollectionTyp 





e(); 
if (elementType == null) ( 
if (descriptor.isRequired()) { 
throw new FatalBeanException("No element t 
ype declared for 
collection [" + type.getName() + "]"); 


return null; 
} 
Map<String, Object> matchingBeans = findAutowireCa 
ndidates(beanName, 
elementType, descriptor); 
if (matchingBeans.isEmpty()) { 
if (descriptor.isRequired()) { 
raiseNoSuchBeanDefinitionException(element 
Type, "collection of " + elementType.getName(), descriptor); 


j 


return null; 


if (autowiredBeanNames !- null) { 
autowiredBeanNames.addAll(matchingBeans.keySet 
O); 
} 


TypeConverter converter = (typeConverter != null ? 
typeConverter 
getTypeConverter()); 
return converter.convertIfNecessary(matchingBeans. 
values(), type); 


// 属 性 是 Map 类 型 
else if (Map.class.isAssignableFrom(type) && type.isIn 
terface()) { 
Class<?> keyType = descriptor.getMapKeyType(); 
if (keyType -- null || !String.class.isAssignableF 
rom(keyType)) { 





if (descriptor.isRequired()) { 
throw new FatalBeanException("Key type [" 
+ keyType + "] of 
map [" + type.getName() + 
"] must be assignable to [java.lan 
g.String]"); 


return null; 
} 
Class<?> valueType = descriptor.getMapValueType(); 
if (valueType == null) { 

if (descriptor.isRequired()) { 

throw new FatalBeanException("No value typ 
e declared for map [" + type.getName() + "]"); 
} 


return null; 
} 
Map<String, Object> matchingBeans = findAutowireCa 
ndidates(beanName, 
valueType, descriptor); 
if (matchingBeans.isEmpty()) { 
if (descriptor.isRequired()) { 
raiseNoSuchBeanDefinitionException(valueTy 
pe, "map with value type 
" * valueType.getName(), descriptor); 


return null; 


j 


if (autowiredBeanNames !- null) { 


autowiredBeanNames.addAll(matchingBeans.keySet 


0); 
j 


return matchingBeans; 
yelse ( 
Map<String, Object» matchingBeans = findAutowireCa 
ndidates(beanName, type, 
descriptor); 
if (matchingBeans.isEmpty()) { 
if (descriptor.isRequired()) { 
raiseNoSuchBeanDefinitionException(type, 


", descriptor); 


j 


return null; 


if (matchingBeans.size() » 1) { 

String primaryBeanName - determinePrimaryCandi 
date(matchingBeans, 
descriptor); 

if (primaryBeanName -- null) ( 

throw new NoSuchBeanDefinitionException(ty 

pe, "expected single 
matching bean but found " + 


matchingBeans.size() + ": " + matc 
hingBeans.keySet()); 
} 
if (autowiredBeanNames !- null) { 
autowiredBeanNames.add(primaryBeanName); 
} 


return matchingBeans.get(primaryBeanName); 


























} 
// 已 经 可 以 确定 只 有 一 个 匹配 项 
Map.Entry«String, Object» entry = matchingBeans.en 
trySet(). iterator(). next(); 
if (autowiredBeanNames !- null) { 
autowiredBeanNames.add(entry.getKey()); 











j 


return entry.getValue(); 





寻找 闫 型 的 匹配 执行 顺序 时 ， 痛 先 符 试 使 用 解 
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情况 的 处 理 ， 虽 说 对 于 不 同类 型 处 理 方式 不 一 致 ， 
但 是 大 致 的 思路 还 是 很 相似 的 ， 所 以 函数 中 只 对 数 
组 类 型 进行 了 详细 地 注释 。 





3. applyPropertyValues 


程序 运行 到 这 里 ， 己 经 完成 了 对 所 有 注入 属性 
的 获取 ， 但 是 获取 的 属性 是 以 PropertyValues 形 式 存 
在 的 ， 还 并 没有 应 用 到 已 经 实例 化 的 bean 中 ， 这 一 
工作 是 在 applyPropertyValues 中 。 








protected void applyPropertyValues(String beanName, BeanDefinit 
ion mbd, BeanWrapper bw, 
PropertyValues pvs) { 
if (pvs == null || pvs.isEmpty()) { 
return; 


À 


MutablePropertyValues mpvs - null; 
List«PropertyValue» original; 


if (System.getSecurityManager()!- null) ( 
if (bw instanceof BeanWrapperlImpl) { 
((BeanwrapperlImpl) bw).setSecurityContext(getA 
ccessControlContext()); 


j 


if (pvs instanceof MutablePropertyValues) ( 
mpvs - (MutablePropertyValues) pvs; 
// 如 果 mpvs 中 的 值 已 经 被 转换 为 对 应 的 类 型 那么 可 以 直接 设置 到 bea 


nwapper 中 
if (mpvs.isConverted()) { 
// Shortcut: use the pre-converted values as-i 
S. 
try { 
bw.setPropertyValues(mpvs); 
return; 
} 


catch (BeansException ex) { 
throw new BeanCreationException( 
mbd.getResourceDescription(), bean 
Name, "Error setting property values", ex); 


j 


original = mpvs.getPropertyValueList(); 
jelse ( 
// 如 果 pvs 并 不 是 使 用 MutablePropertyValues 封 装 的 类 型 ， 那 
么 直接 使 用 原始 的 属性 获取 方法 


original = Arrays.asList(pvs.getPropertyValues()); 
} 











TypeConverter converter = getCustomTypeConverter(); 
if (converter -- null) ( 
converter - bw; 


T 
// 获 取 对 应 的 解析 器 


BeanDefinitionValueResolver 





valueResolver - new BeanDefinitionValueResolver(this, beanName, 
mbd, converter); 


// Create a deep copy, resolving any references for va 
lues. 
List<PropertyValue> deepCopy = new ArrayList«PropertyV 
alue>(original.size()); 
boolean resolveNecessary = false; 
/ Ok FJ FS ERR AMY DS HY DY Js PE SS 
for (PropertyValue pv : original) { 
if (pv.isConverted()) { 
deepCopy.add(pv); 
jelse { 
String propertyName = pv.getName(); 














Object originalValue 
Object resolvedValue 


pv.getValue(); 
valueResolver.resolveVa 


lueIfNecessary 


(pv, 
originalValue); 
Object convertedValue - resolvedValue; 
boolean convertible - bw.isWritableProperty(pr 
opertyName) && 
!IPropertyAccessorUtils.isNestedOrIndex 
edProperty (propertyName); 
if (convertible) { 
convertedValue - convertForProperty(resolv 
edValue, propertyName, bw, converter); 


if (resolvedValue == originalValue) { 
if (convertible) ( 
pv.setConvertedValue(convertedValue); 


} 
deepCopy.add(pv); 


else if (convertible && originalValue instance 
of TypedStringValue && 
!((TypedStringValue) originalValue).is 
Dynamic() && 
!(convertedValue instanceof Collection 
|| ObjectUtils.isArray 
(convertedValue))) { 
pv.setConvertedValue(convertedValue); 
deepCopy.add(pv); 


else ( 
resolveNecessary - true; 
deepCopy.add(new PropertyValue(pv, convert 
edValue)); 


} 
} 
if (mpvs !- null && !resolveNecessary) { 
mpvs.setConverted(); 
} 
try { 


bw.setPropertyValues(new MutablePropertyValues(dee 
pCopy)); 


catch (BeansException ex) { 
throw new BeanCreationException( 
mbd.getResourceDescription(), beanName, "E 
rror setting property 
values", ex); 
} 
} 





5.7.4 初始 化 bean 


大 家 应 该 记得 在 bean 配 置 时 bean 中 有 一 个 init- 
method 的 属性 ， 这 个 属性 的 作用 是 在 bean 实 例 化 前 
调用 init-method 指 定 的 方法 来 根据 用 户 业 务 进行 相 
应 的 实例 化 。 我 们 现在 就 已 经 进入 这 个 方法 了 ， 首 
先 看 一 下 这 个 方法 的 执行 位 置 ，Spring 中 程序 已 经 
执行 过 bean 的 实例 化 ， 并 且 进 行 了 属性 的 填充 ， 而 
就 在 这 时 将 会 调用 用 户 设 定 的 初始 化 方法 。 

















protected Object initializeBean(final String beanName, final Ob 
Ject bean, RootBean Definition 
mbd) { 


if (System.getSecurityManager() !- null) { 
AccessController.doPrivileged(new PrivilegedAction 
<Object>() { 
public Object run() { 
invokeAwareMethods 


(beanName, bean); 
return null; 


} 
}, getAccessControlContext()); 
} 


else ( 
// 对 特殊 的 bean 处 理 :Aware、BeanClassLoaderAware、BeanF 
actoryAware 
invokeAwareMethods 























(beanName, bean); 

















} 

Object wrappedBean = bean; 

if (mbd == null || !mbd.isSynthetic()) { 
// 应 用 后 处 理 器 





wrappedBean = applyBeanPostProcessorsBeforeInitial 
ization 


(wrappedBean, beanName); 


try 





1 
// 激 活用 户 自 定义 的 init 方 法 
invokelnitMethods 





(beanName, wrappedBean, mbd); 


} 
catch (Throwable ex) { 
throw new BeanCreationException( 




















(mbd != null ? mbd.getResourceDescription( 
) : null), 
beanName, "Invocation of init method faile 
d", ex); 
} 
if (mbd == null || !mbd.isSynthetic()) { 
// 后 处 理 器 应 用 
wrappedBean = applyBeanPostProcessorsAfterInitiali 
zation 


(wrappedBean, beanName); 


return wrappedBean; 








虽然 说 此 函数 的 主要 目的 是 进行 客户 设 定 的 初 
始 化 方法 的 调用 ， 但 是 除 此 之 外 还 有 些 其 他 必要 的 
工作 。 


1. 激活 Aware 方 法 


在 分 析 其 原理 之 前 ， 我 们 先 了 解 一 下 Aware 的 
使 用 。Spring 中 提供 一 些 Aware 相 关 接 口 ， 比 如 
BeanFactoryAware、ApplicationContextAware、 
ResourceLoaderAware、ServletContextAware 等 ， 实 
现 这 些 Aware 接 口 的 bean 在 被 初始 之 后 ， 可 以 取得 
一 些 相对 应 的 资源 ， 例 如 实现 BeanFactoryAware 的 
bean 在 初始 后 ，Spring 容 器 将 会 注入 BeanFactory 的 
实例 ， 而 实现 ApplicationContextAware 的 bean， 在 
bean 被 初始 后 ， 将 会 被 注入 ApplicationContext 的 实 
。 我 们 首先 通过 示例 方法 来 了 解 一 下 Aware 的 

用 。 


1. 定义 普通 bean。 


public class Hello ( 
public void say() { 
System.out.println("hello"); 


j 





2. 定义 BeanFactoryAware 类 型 的 bean。 


public class Test implements BeanFactoryAware { 
private BeanFactory beanFactory; 


// 声明 bean 的 时 候 Spring 会 自动 注入 BeanFactory 
@Override 
public void setBeanFactory(BeanFactory beanFactory) throws 
BeansException { 
this.beanFactory = beanFactory; 


} 
public void testAware() { 
// 通过 hello 这 个 bean id 从 beanFactory 获 取 实 例 
Hello hello = (Hello) beanFactory.getBean("hello") 


hello.say(); 





3. 使 用 main 方 法 测试 。 


public static void main(String[] s) { 

ApplicationContext ctx = new ClassPathXmlApplicationContex 
t("applicationContext.xml"); 

Test test = (Test) ctx.getBean("test"); 


test.testAware(); 





运行 测试 类 ， 控 制 台 输 出 : 


按照 上 面 的 方法 我 们 可 以 获取 到 Spring 中 
BeanFactory, Jf H.uJ ER Hi BeanFactory 3X UJ 
bean， 以 及 进行 相关 设置 。 当 然 还 有 其 他 Aware 的 











使 用 方法 部 大 同 小 寞 ， 看 一 下 Spring 的 实现 方式 ， 
相信 读者 便 会 使 用 了 。 





private void invokeAwareMethods(final String beanName, fin 
al Object bean) { 
if (bean instanceof Aware) { 
if (bean instanceof BeanNameAware 


((BeanNameAware) bean).setBeanName(beanName) ; 


j 


if (bean instanceof BeanClassLoaderAware 


) i 
((BeanClassLoaderAware) bean).setBeanClassLoad 
er(getBeanClassLoader()); 


if (bean instanceof BeanFactoryAware 


) 1 

((BeanFactoryAware) bean).setBeanFactory(Abstr 
actAutowire CapableBean 
Factory.this); 


j 





代码 简单 得 已 经 没有 什么 好 次 的 了 。 读 者 可 以 
自己 答 试 使 用 别 的 Aware， 都 比较 简单 。 





2. 处 理 器 的 应 用 


BeanPostProcessor 相 信 大 家 都 不 陌生 ， 这 是 
Spring 中 开放 式 架 构 中 一 个 必 不 可 少 的 亮点 ， 给 用 








户 充 足 的 权限 去 更 改 或 者 扩展 Spring， 而 除了 
BeanPostProcessor 外 还 有 很 多 其 他 的 PostProcessor， 
当然 大 部 分 都 是 以 此 为 基础 ， 继 承 目 
BeanPostProcessor。BeanPostProcessor 的 使 用 位 置 
束 是 这 里 ， 在 调用 客户 自 定 义 初 始 化 方法 前 以 及 调 
用 目 定 义 初始 化 方法 后 分 别 会 调用 
BeanPostProcessor 的 postProcessSBeforeInitialization 和 
postProcessAfterInitialization 方 法 ， 使 用 户 可 以 根据 
目 己 的 业务 需求 进行 啊 应 的 处 理 。 








public Object applyBeanPostProcessorsBeforeInitialization(Objec 
t existingBean, String beanName) 
throws BeansException { 


Object result - existingBean; 
for (BeanPostProcessor beanProcessor : getBeanPostProc 
essors()) ( 
result - beanProcessor.postProcessBeforeInitializa 
tion 


(result, beanName); 
if (result -- null) ( 
return result; 
} 
} 


return result; 


j 


public Object applyBeanPostProcessorsAfterInitialization(Object 
existingBean, String 
beanName ) 

throws BeansException { 


Object result - existingBean; 
for (BeanPostProcessor beanProcessor : getBeanPostProc 
essors()) ( 
result - beanProcessor.postProcessAfterInitializat 
ion 


(result, beanName); 
if (result -- null) ( 
return result; 
} 
} 


return result; 





3. 激活 目 定义 的 init 方 法 


客户 定制 的 初始 化 方法 除了 我 们 玖 知 的 使 用 配 
置 init-method 外 ， 还 有 使 目 定 义 的 bean 实 现 
InitializingBean 接 口 ， 并 在 afterPropertiesSet 中 实现 
目 己 的 初始 化 业务 逻辑 。 


init-method 与 afterPropertiesSet 都 是 在 初始 化 
bean 时 执行 ， 执 行 顺 序 是 afterPropertiesSet 先 执行 ， 
而 init-method 后 执行 。 





在 invokeInitMethods 方 法 中 束 实 现 了 这 两 个 步 
又 的 初始 化 方法 调用 。 





protected void invokeInitMethods(String beanName, final Object 
bean, RootBeanDefinition mbd) 
throws Throwable ( 








// 首 先 会 检查 是 否 是 InitializingBean， 如 果 是 的 话 需要 调用 afterPrope 
rtiesSet 方 法 
boolean isInitializingBean = (bean instanceof Initiali 
zingBean); 
if (isInitializingBean && (mbd -- null || !mbd.isExter 
nally ManagedInitMethod ("afterPropertiesSet"))) { 











if (logger.isDebugEnabled()) (1 
logger.debug("Invoking afterPropertiesSet() on 
bean with name '" + 
beanName + "'"); 


} 
if (System.getSecurityManager() !- null) { 
try { 
AccessController.doPrivileged(new Privileg 
edExceptionAction 
<Object>() { 
public Object run() throws Exception { 
((InitializingBean) bean).afterPro 
pertiesSet(); 
return null; 


}, getAccessControlContext()); 


catch (PrivilegedActionException pae) { 
throw pae.getException(); 
} 
}else { 
// 属 性 初始 化 后 的 处 理 
((InitializingBean) bean).afterPropertiesSet() 























j 


if (mbd != null) { 
String initMethodName = mbd.getInitMethodName(); 
if (initMethodName !- null && !(isInitializingBean 
&& "afterPropertiesSet". equals(initMethodName)) && 
!mbd.isExternallyManagedInitMethod(initMet 
hodName)) { 





// 调 用 自 定 义 初 始 化 方法 
invokeCustomInitMethod(beanName, bean, mbd); 








5.7.5 ”注册 DisposableBean 





Spring 中 不 但 提供 了 对 于 初始 化 方法 的 扩展 入 
口 ， 同 样 也 提供 了 销毁 方法 的 扩展 入 口 ， 对 于 销毁 
方法 的 扩展 ， 除 了 我 们 熟知 的 配置 属性 destroy- 
method 方 法 外 ， 用 户 还 可 以 注册 后 人 处理 器 
DestructionAwareBeanPostProcessor 来 统一 处 理 bean 
的 销 贤 方法 ， 代 人 码 如 下 : 











protected void registerDisposableBeanIfNecessary(String beanNam 
e, Object bean, 
RootBeanDefinition mbd) ( 

AccessControlContext acc - (System.getSecurityManager( 















































) != null ? getAccessControlContext 
() : null); 
if (!mbd.isPrototype() && requiresDestruction(bean, mb 
d))t 
if (mbd.isSingleton()) (1 
/* 
* 单 例 模式 下 广 册 需要 销毁 的 bean， 此 方法 中 会 处 理 实 现 Dis 
posableBeanf]bean, 
* 并 且 对 所 有 的 bean 使 用 DestructionAwareBeanPostPr 
ocessors 处 理 
* DisposableBean DestructionAwareBeanPostProc 
essors, 
*/ 
registerDisposableBean 
(beanName, 


new DisposableBeanAdapter (bean, beanNa 
me, mbd, getBeanPostProcessors 


(), acc)); 




















* 自 定义 scope 的 处 理 
*/ 
Scope scope = this.scopes.get(mbd.getScope()); 
if (scope == null) { 
throw new IllegalStateException("No Scope 
registered for scope '" + mbd.getScope() + "'"); 





scope.registerDestructionCallback 


(beanName, 
new DisposableBeanAdapter(bean, beanNa 


me, mbd, getBeanPostProcessors 


(), acc)); 
j 


j 





HO Aas Whey He 


经 过 前 面 几 章 的 分 析 ， 相 信 大 家 已 经 对 Spring 
中 的 容器 功能 有 了 简单 的 了 解 ， 在 前 面 的 章节 中 我 
们 一 直 以 BeanFacotry 接 口 以 及 它 的 默认 实现 类 
XmlBeanFactory 为 例 进 行 分 析 ， 但 是 ，Spring 中 还 
提供 了 男 一 个 接口 ApplicationContext， 用 于 扩展 
BeanFacotry 中 现 有 的 功能 。 








ApplicationContext 和 BeanFacotry 两 者 都 是 用 于 
加 载 Bean 的 ， 但 是 相 比 之 下 ，Application- Context 
提供 了 更 多 的 扩展 功能 ， 简 蛙 一 扣 说 : 
ApplicationContext 包 含 BeanFactory 的 所 有 功能 。 通 
第 建 议 比 BeanFactory 优 先 ， 除 非 在 一 些 限制 的 场 
合 ， 比 如 字 节 长 度 对 内 存 有 很 大 的 影响 时 

(Applet) 。 绝 大 多 数 “" 典 型 的 ?企业 应 用 和 系统 ， 
ApplicationContext 就 是 你 需要 使 用 的 。 


那么 究 葛 ApplicationContext 比 BeanFactory 多 出 
了 哪些 功能 呢 ? 还 需要 我 们 进一步 的 探索 。 首 移 我 
们 来 看 看 使 用 两 个 不 同 的 类 去 加 载 配 置 文件 在 写法 
上 的 不 同 。 











e [ii HjBeanFactory77 3X JH ZX XML. 


BeanFactory bf = new XmlBeanFactory(new ClassPathResource("b 
eanFactoryTest.xml")); 





。 使 用 ApplicationContext 方 式 加载 XML 。 


ApplicationContext bf = new ClassPathXmlApplicationContext("bea 
nFactoryTest.xml"); 





同样 ， 我 们 还 是 以 
ClassPathXmlApplicationContext 作 为 切入 点 ， 开 始 
对 整体 功能 进行 分 析 。 
public ClassPathXmlApplicationContext(String configLocation) th 


rows BeansException { 
this 





(new String[] {configLocation}, true, null); 

} 

public ClassPathXmlApplicationContext(String[] configLocations, 
boolean refresh, 

ApplicationContext parent) throws BeansException { 


super(parent); 
setConfigLocations 


(configLocations); 
if (refresh) { 
refresh 


MEM 


设置 路 径 是 必 不 可 少 的 步 又 ， 
ClassPathXmlApplicationContext 中 可 以 将 配置 文件 
路 径 以 数组 的 方式 传 入 ， 
ClassPathXmlA pplicationContextF] 以 对 数组 进行 解 
析 并 进行 加 载 。 而 对 于 解析 及 功能 实现 都 在 
refresh() 中 实现 。 


6.1 设置 配置 路 径 





在 ClassPathXmlApplicationContext 中 文 持 多 个 
配置 文件 以 数组 方式 同时 传 入 : 








public void setConfigLocations(String[] locations) { 
if (locations !- null) ( 
Assert.noNullElements(locations, "Config locations 
must not be null"); 
this.configLocations - new String[locations.length 


]; 
for (int i = 0; i < locations.length; i++) { 
// 解 析 给 定 路 径 
this.configLocations[i] = resolvePath 








(locations[i]).trim(); 


else { 
this.configLocations = null; 


j 





此 函数 主要 用 于 解析 给 定 的 路 径 数 组 ， 当 然 ， 
如 果 数 组 中 包含 特殊 符 写 ， 如 ${var}， 那 么 在 
resolvePath 中 会 搜寻 匹配 的 系统 变量 并 替换 。 


62 扩展 功能 


设置 了 路 径 之 后 ， 便 可 以 根据 路 径 做 配置 文件 
的 解析 以 及 各 种 功能 的 实现 了 。 可 以 说 refresh 函 数 
中 包含 了 几乎 ApplicationContext 中 提供 的 全 部 功 
能 ， 而 且 此 函数 中 思 辑 非 钊 清晰 明了 ， 使 我 们 很 容 
易 分 析 对 应 的 层次 及 逻辑 。 














public void refresh() throws BeansException, IllegalStateExcept 
ion ( 


synchronized (this.startupShutdownMonitor) ( 
/ TE BTA E P SCA BE 
prepareRefresh 


0; 

// Tell the subclass to refresh the internal bean 
factory. 

// 初 始 化 BeanFactory， 并 进行 XML 文件 读 取 

ConfigurableListableBeanFactory beanFactory = obta 
inFreshBeanFactory 


0; 
// Prepare the bean factory for use in this contex 


// 对 BeanFactory 进 行 各 种 功能 填充 
prepareBeanFactory 


(beanFactory); 


try { 
// Allows post-processing of the bean factory 

in context subclasses. 
// FPR i TEACUP AE 


postProcessBeanFactory 

















(beanFactory); 














// 激 活 各 种 BeanFactory 处 理 器 
invokeBeanFactoryPostProcessors 








(beanFactory); 




















// 注册 拦截 Bean 创 建 的 Bean 处 理 器 , 这 里 只 是 注册 ， 真 正 的 
调用 是 在 getBean 时 候 
registerBeanPostProcessors 





(beanFactory); 


// 为 上 下 文 初始 化 Message 源 ， 即 不 同 语言 的 消息 体 ， 国 际 























化 处 理 

initMessageSource 
(0; 

// Initialize event multicaster for this conte 
xt. 

// 初始 化 应 用 消息 广播 器 ， 并 放 入 “applicationEventMul 
ticaster”bean 中 


initApplicationEventMulticaster 


(0; 


// Initialize other special beans in specific 
context subclasses. 

// 留 给 子 类 来 初始 化 其 它 的 Bean 

onRefresh 





// Check for listener beans and register them. 
// 在 所 有 注册 的 bean 中 查找 Listener bean， 注 册 到 消息 





广播 器 中 





registerListeners 


(0; 


// Instantiate all remaining (non-lazy-init) s 


ingletons. 


// 初始 化 剩 下 的 单 实例 〈 非 惰性 的 ) 





finishBeanFactoryInitialization 


(beanFactory); 


// Last step: publish corresponding event. 














// 完成 刷新 过 程 ， 通 知 生命 周期 处 到 











r 刷 新 过 程 ， 同 时 发 出 


Eas lifecycleProcesso 


//ContextRefreshEven ti Hl A 


finishRefresh 


j 


catch (BeansException ex) ( 


// Destroy already created singletons to avoid 


dangling resources. 
destroyBeans 


(0; 


// Reset 'active' flag. 
cancelRefresh 


(ex); 


// Propagate exception to caller. 


throw ex; 





下 面 概括 一 下 ClassPathXmlApp 
初始 化 的 步 又， 并 从 中 解释 一 下 它 为 我 们 提供 的 功 


Sb 
HE o 


licationContext 


1. 初始 化 前 的 准备 工作 ， 例 如 对 系统 属性 或 
者 环境 变量 进行 准备 及 验证 。 


在 某 种 情况 下 项 目的 使 用 需要 读 取 某 些 系 统 变 
量 ， 而 这 个 变量 的 设置 很 可 能 会 影 啊 着 系统 的 正确 
性 ， 那 么 ClassPathXmlApplicationContext 为 我 们 提 
供 的 这 个 准备 函数 就 显得 非常 必要 ， 它 可 以 在 
Spring 局 动 的 时 候 提 前 对 必需 的 变量 进行 存在 性 验 
Lbs 











2. 初始 化 BeanFactory， 并 进行 XML 文件 读 
B. 


ZHU A te 2!|ClassPathXmlA pplicationContext, 
含 着 BeanFactory 所 提供 的 一 切 特 征 ， 那 么 在 这 一 步 
又 中 将 会 复 用 BeanFactory 中 的 配置 文件 读 取 解析 及 
其 他 功能 ， 这 一 步 之 后 ， 
ClassPathXmlApplicationContext 实 际 上 就 已 经 包含 
了 BeanFactory 所 提供 的 功能 ， 也 就 是 可 以 进行 bean 
的 提取 等 基础 操作 了 o 


3. 对 BeanFactory 进 行 各 种 功能 填充 。 
(@Qualifier 与 @Autowired 应 该 是 大 家 非常 熟悉 


的 注解 ， 那 么 这 两 个 注解 正 是 在 这 一 步骤 中 增加 的 
文 持 。 











4. FRA mI VERSUS BS] RB e 


Spring ATLAS AK, TE ARTES, ER OED) 
能 上 为 大 家 提供 了 便 例 外 ， 还 有 一 方面 是 它 的 完美 
染 构 ， 开 放 式 的 架构 让 使 用 它 的 程序 员 很 容易 根据 
业务 需要 扩展 已 经 存在 的 功能 。 这 种 开放 式 的 设计 
在 Spring 中 随处 可 见 ， 例 如 在 本 例 中 束 提 供 了 一 个 
空 的 函数 实现 postProcess- BeanFactory 来 方便 程序 
员 在 业务 上 做 进一步 扩展 。 


5. 激活 各 种 BeanFactory 处 理 器 。 


6. 注册 拦截 bean 创 建 的 bean 人 处 理 器 ， 这 里 只 
是 注册 ， 真 正 的 调用 是 在 getBean 时 候 。 


7. 为 上 下 文 初 始 化 Message 源 ， 即 对 不 同 语言 
HE EAE ET E by HAD EE 


8. 4) NLROI RJ duas. FPG 
Ax*applicationEventMulticaster"bean"F 。 


9. 留 给 子 类 来 初始 化 其 他 的 bean。 


10. 在 所 有 注册 的 bean 中 查找 listener beaan， 注 
MEA) fw. 


11. 初始 化 剩 下 的 单 实例 〈 非 惰性 的 ) 。 























12. 完成 刷新 过 程 ， 通 知 生 命 周 期 处 理 器 
lifecycleProcessor 刷 新 过 程 ， 同 时 发 出 Context- 
RefreshEvent 通 知 别 人 。 


63 ”环境 准备 


prepareRefresh K Zi 3: 9 ze fip Ee $e Lf E, Pur 
对 系统 属性 及 环境 变量 的 初始 化 及 验证 。 


protected void prepareRefresh() { 
this.startupDate - System.currentTimeMillis(); 


synchronized (this.activeMonitor) { 
this.active - true; 


} 
if (logger.isInfoEnabled()) { 
logger.info("Refreshing " + this); 


// ER RG hi 
initPropertySources 














// 验 证 需要 的 属性 文件 是 否 都 已 经 放 入 环境 中 
getEnvironment().validateRequiredProperties(); 














网 上 有 人 说 其 实 这 个 函数 没什么 用 ， 因 为 最 后 
两 名 代码 才 是 最 为 关键 的 ， 但 是 却 没 有 什么 逻辑 处 





理 ，initPropertySources 是 空 的 ， 没 有 任何 逻辑 ， 而 
getEnvironment().validateRequiredProperties tH. [4] Ai 
有 需要 验证 的 属性 而 没有 做 任何 处 理 。 其 实 这 都 是 
因为 没有 彻底 理解 才 会 这 么 说 ， 这 个 函数 如 采用 好 
了 作用 还 是 挺 大 的 。 那 么 ， 访 怎么 用 呢 ? 我 们 先 探 
索 下 各 个 函数 的 作用 。 











1. initPropertySources E ^j @ Spring HFT i o £i 
构 设 计 ， 给 用 户 最 大 扩展 Spring 的 能 力 。 用 户 可 以 
根据 自身 的 需要 重 写 initPropertySources 方 法 ， 并 在 
方法 中 进行 个 性 化 的 属性 处 理 及 设置 。 


2. validateRequiredProperties 则 是 对 属性 进行 
验证 ， 那 么 如 何 验 证 呢 ? 我 们 举 个 融合 两 句 代 人 码 的 
小 例子 来 帮助 大 家 理解 。 


假如 现在 有 这 样 一 个 需求 ， 工 程 在 运行 过 程 中 
用 到 的 某 个 设置 〈 例 如 VAR) 是 从 系统 环境 变量 中 
取得 的 ， 而 如 果 用 户 没有 在 系统 环境 变量 中 配置 这 
个 参数 ， 那 么 工程 可 能 不 会 工作 。 这 一 要 求 可 能 会 
有 各 种 各 样 的 解雇 办法， 当然， 在 Spring 中 可 以 这 
ClassPathXmlApplicationContext。 当 然 ， 最 好 的 办 
法 还 是 对 源码 进行 扩展 ， 我 们 可 以 目 定 义 类 : 


public class MyClassPathXmlApplicationContext extends ClassPath 
XmlApplicationContext{ 











public MyClassPathXmlApplicationContext(String... configLo 
cations ){ 


super(configLocations); 


protected void initPropertySources() ( 

// 添 加 验证 要 求 
getEnvironment().setRequiredProperties("VAR"); 

} 














我 们 日 定义 了 继承 日 
ClassPathXmlApplicationContext 的 
MYyClassPathXmlApplicationContext， 并 重 写 了 





initPropertySources 方 法 ， 在 方法 中 添加 了 我 们 的 个 
性 化 需求 ， 那 么 在 验证 的 时 候 也 束 是 程序 走 到 
getEnvironment().validateRequiredProperties()1 14 Hy 
时 候 ， 如 果 系 统 并 没有 检测 到 对 应 VAR 的 环境 变 
星 ， 那 么 将 殷 出 寞 第 。 当 然 我 们 还 需要 在 使 用 的 时 
候 蔡 换 掉 原 有 的 ClassPathXmlApplicationContext: 





public static void main(String[] args) { 
ApplicationContext bf - new MyClassPathXmlApplicationC 


ontext 


("test/customtag/ test.xml"); 
User user=(User) bf.getBean("testbean"); 
} 





6.4 ”加 载 BeanFactory 


obtainFreshBeanFactory 方 法 从 字面 理解 是 获取 
BeanFactory。 之 前 有 说 过 ，Application- Context 
对 BeanFactory 的 功能 上 的 扩展 ， 不 但 包含 
BeanFactory 的 全 部 功能 更 在 其 基础 上 添加 了 大 量 的 
扩展 应 用 ， 那 么 obtainFreshBeanFactory 正 是 实现 
BeanFactory 的 地 方 ， 也 束 是 经 过 了 这 个 函数 后 
ApplicationContext 吏 已 经 拥有 了 BeanFactory 的 全 部 
功能 。 
protected ConfigurableListableBeanFactory obtainFreshBeanFactor 
TE // 初 始 化 BeanFactory， 并 进行 XML 文件 读 取 , 并 将 得 到 的 BeanFacotry 


记录 在 当前 实体 的 属性 中 


refreshBeanFactory 














// 返 回 当 前 实体 的 beanFactory 属 性 
ConfigurableListableBeanFactory beanFactory = getBeanF 





actory(); 
if (logger.isDebugEnabled()) { 
logger.debug("Bean factory for " + getDisplayName( 
) + ": " + beanFactory); 


j 


return beanFactory; 








方法 中 将 核心 实现 委托 给 了 


refreshBeanFactory: 





QOverride 
protected final void refreshBeanFactory() throws BeansException 


1 


if (hasBeanFactory()) { 


destroyBeans(); 
closeBeanFactory(); 
} 
try { 
// 创 建 DefaultListableBeanFactory 
DefaultListableBeanFactory beanFactory = createBea 





nFactory(); 








// 为 了 序列 化 指定 id， 如 果 需 要 的 话 , 让 这 个 BeanFactory 从 id 反 
序列 化 到 BeanFactory 对 象 

beanFactory.setSerializationId(getId()); 

// 定 制 beanFactory， 设 置 相关 属性 ， 包 括 是 否 允 许 履 盖 同 名 称 的 
不 同 定义 的 对 象 以 及 循环 依赖 以 及 

// 设 置 QAutowired 和 @Qualifier 注 解 解析 器 QualifierAnnot 
ationAutowire- 

//CandidateResolver 

customizeBeanFactory 




















(beanFactory); 
// 初 始 化 DodumentReader， 并 进行 XML 文件 读 取 及 解析 
loadBeanDefinitions 








(beanFactory); 
synchronized (this.beanFactoryMonitor) { 
this.beanFactory - beanFactory; 


$ 


catch (IOException ex) { 
throw new ApplicationContextException("I/O error p 
arsing bean definition source for " + getDisplayName(), ex); 
} 
} 





AA VES DT E B) REI R -o 


1. 创建 DefaultListableBeanFactory。 


在 介绍 BeanFactory 的 时 候 ， 不 知道 读者 是 否 还 
有 印象 ， 声 明 方式 为 : BeanFactory bf = new 
XmlBeanFactory("beanFactoryTest.xml")， 其 中 的 
XmlBeanFactory2*7& E] DefaultListableBean- 
Factory， 并 提供 了 XmlBeanDefinitionReader 类 型 的 
reader) tt, that biDefaultListableBean- Factory 
是 容器 的 基础 。 必 须 站 先 要 实例 化 ， 那 么 在 这 里 就 
是 实例 化 DefaultListableBeanFactory 的 步骤 。 


2. 指定 序 列 化 ID。 

3. 定制 BeanFactory。 

4. 加 载 BeanDefinition。 

5. 使 用 全 局 变量 记录 BeanFactory 类 实例 。 
为 DefaultListableBeanFactory 类 型 的 变量 


beanFactory 是 函数 内 的 局 部 变量 ， 所 以 要 使 用 全 局 
变量 记录 解析 结果 。 


6.4.4 定制 BeanFactory 





这 里 已 经 开始 了 对 BeanFactory 的 扩展 ， 在 基本 
容器 的 基础 上 ， 增 加 了 是 否 允 许 履 辣 是 否 允 许 扩 展 
的 设置 并 提供 了 注解 @Qualifier 和 @Autowired 的 文 


B. 


protected void customizeBeanFactory(DefaultListableBeanFactory 
beanFactory) { 

// 如 果 属 性 allowBeanDefinitionOverriding 不 为 空 ， 设 置 给 beanF 
actory 对 象 相应 属性 ， 

// 此 属性 的 含义 : 是 否 允 许 覆 盖 同 名 称 的 不 同 定义 的 对 象 

if (this.allowBeanDefinitionOverriding !- null) ( 

beanFactory.setAllowBeanDefinitionOverriding(this. 

allowBeanDefinitionOverriding); 














// 如 果 属 性 allowCircularReferences 不 为 空 ， 设 置 给 beanFactory 
对 象 相应 属性 ， 

// 此 属性 的 含义 是 否 允 许 bean 之 间 存 在 循环 依赖 

if (this.allowCircularReferences !- null) ( 

















beanFactory.setAllowCircularReferences(this.allowC 
ircularReferences); 


} 

// 用 于 @Qualifier 和 @Autowired 

beanFactory.setAutowireCandidateResolver(new Qualifier 
AnnotationAutowireCandidateResolver 


()); 
j 





AY FIC EA st FIC VT ORY Uc Eric E ee UIS 
TÆERNE, WRDAA BET ME, BEFRA 
看 到 在 哪里 进行 设置 ， 完 葛 这 个 设置 是 在 哪里 进行 
a Sen ek a 
IH: 





public class MyClassPathXmlApplicationContext extends ClassPath 
XmlApplicationContext{ 


protected void customizeBeanFactory(DefaultListableBeanFa 


ctory beanFactory) { 
super.setAllowBeanDefinitionOverriding(false); 
super.setAllowCircularReferences(false); 
super.customizeBeanFactory(beanFactory); 








设置 完 后 相信 大 家 已 经 对 于 这 两 个 属性 的 使 用 





有 上 所 了 解 ， 或 者 可 以 回 到 前 面 的 章节 进行 再 一 次 碍 
看 。 对 于 定制 BeanFactory，Spring 还 提供 了 另外 一 
个 重要 的 扩展 ， 束 是 设置 Autowire- 
CandidateResolver， 在 bean 加 载 部 分 中 讲解 创建 
Bean 时 ， 如 果 采 用 autowireByType 方 式 注 入 ， 那 么 
默认 会 使 用 Spring 提供 的 
SimpleAutowireCandidateResolver， 而 对 于 默认 的 实 
现 并 没有 过 多 的 逻辑 处 理 。 在 这 里 ，Spring 使 用 了 
QualifierAnnotationAutowireCandidateResolver, 1 
置 了 这 个 解析 器 后 Spring 束 可 以 支持 注解 方式 的 注 
和 


在 讲解 根据 类 型 自 定 注 入 的 时 候 ， 我 们 说 过 解 
析 autowire 类 型 时 首先 会 调用 方法 : 


Object value = getAutowireCandidateResolver().getSuggestedValue 
(descriptor); 


因此 我 们 知道 ， 在 


QualifierAnnotationAutowireCandidateResolver 中 一 











定 会 提供 了 解析 Qualifier 与 Autowire 注 解 的 方法 。 
QualifierAnnotationAutowireCandidateResolver.java 


public Object getSuggestedValue(DependencyDescriptor descriptor 
) { 
Object value = findValue(descriptor.getAnnotations()); 
if (value == null) { 
MethodParameter methodParam = descriptor.getMethod 
Parameter(); 
if (methodParam !- null) ( 


value - findValue(methodParam.getMethodAnnotat 


ions()); 


j 


return value; 





6.4.2 JlzXBeanDefinition 


在 第 一 步 中 提 到 了 将 
ClassPathXmlApplicationContext 与 XmlBeanFactory 
创建 的 对 比 ， 在 实现 配置 文件 的 加 载 功 能 中 除了 我 
们 在 第 一 步 中 已 经 初始 化 的 
DefaultListableBeanFactory 外 ， 还 需要 
XmlBeanDefinitionReader 来 读 取 XML， 那 么 在 这 个 
AB BRP e um S SC a 


XmlBeanDefinitionReader. 


QOverride 
protected void loadBeanDefinitions(DefaultListableBeanFact 


ory beanFactory) throws BeansException, IOException { 
// 为 指定 beanFactory 创 建 XmlBeanDefinitionReader 
XmlBeanDefinitionReader beanDefinitionReader = new Xml 
BeanDefinitionReader 
(beanFactory); 











// 对 beanDefinitionReader 进 行 环境 变量 的 设置 
beanDefinitionReader.setEnvironment(this.getEnvironmen 





t()); 
beanDefinitionReader.setResourceLoader(this); 
beanDefinitionReader.setEntityResolver(new ResourceEnt 
ityResolver(this)); 





// 对 BeanDefinitionReader 进 行 设置 ， 可 以 履 盖 
initBeanDefinitionReader(beanDefinitionReader); 


loadBeanDefinitions 


(beanDefinitionReader); 


j 





在 初始 化 了 DefaultListableBeanFactory 和 
XmlBeanDefinitionReader/ri Wi n] DAE 7 Wü BLOCTERS 
iA T. 





protected void loadBeanDefinitions(XmlBeanDefinitionReader read 
er) throws BeansException, IOException { 
Resource[] configResources = getConfigResources(); 
if (configResources != null) { 
reader .loadBeanDefinitions 


(configResources); 
String[] configLocations - getConfigLocations(); 
if (configLocations !- null) { 
reader .loadBeanDefinitions 


(configLocations) ; 


eo 
fii F] XmlBeanDefinitionReaderH] 
loadBeanDefinitions 方 法 进行 配置 文件 的 加 载 机 注册 
相信 大 家 已 经 不 陌生 ， 这 完全 就 是 开始 BeanFactory 
的 套路 。 因 为 在 XmlBeanDefinitionReader 中 已 经 将 
之 前 初始 化 的 DefaultListableBeanFactory 注 册 进 去 
了 ， 上 所 以 XmlBeanDefinitionReader 所 旋 取 的 
BeanDefinitionHolder 都 会 注册 到 
DefaultListableBeanFactory 中 ， 也 就 是 经 过 此 步 
BR, 287 DefaultListableBeanFactory If] AE Œ: 
beanFactory 已 经 包含 了 所 有 解析 好 的 配置 。 


6.5 ”功能 扩展 











进入 函数 prepareBeanFactory 表 ，Spring 已 经 完 
成 了 对 配置 的 解析 ， 而 ApplicationContext 在 功能 
的 扩展 也 由 此 展开 。 





protected void prepareBeanFactory(ConfigurableListableBeanFacto 
ry beanFactory) { 


// 设 置 beanFactory 的 classLoader 为 当前 context 的 classLoader 
beanFactory.setBeanClassLoader(getClassLoader()); 

















// 设 置 beanFactory 的 表达 式 语言 处 理 器 ，Spring3 增 加 了 表达 式 语言 








的 支持 ， 








// 默 认可 以 使 用 #{bean .xxx} 的 形式 来 调用 相关 属性 值 。 


beanFactory.setBeanExpressionResolver 


(new StandardBeanExpressionResolver()); 








// 为 beanFactory 增 加 了 一 个 默认 的 propertyEditor， 这 个 主要 是 对 b 
ean 的 属性 等 设置 管理 的 

// 个 工具 

beanFactory.addPropertyEditorRegistrar 
































(new ResourceEditorRegistrar(this, getEnvironment())); 


/* 
* 添加 BeanPostProcessor ， 
*/ 
beanFactory .addBeanPostProcessor 


(new ApplicationContextAwareProcessor(this)); 














// 设 置 了 几 个 忽略 自动 装配 的 接口 

beanFactory.ignoreDependencyInterface(ResourceLoaderAw 
are.class); 

beanFactory.ignoreDependencyInterface(ApplicationEvent 
PublisherAware.class); 

beanFactory.ignoreDependencyInterface(MessageSourceAwa 
re.class); 

beanFactory.ignoreDependencyInterface(ApplicationConte 
xtAware.class); 

beanFactory.ignoreDependencyInterface(EnvironmentAware 
.class); 

















// 设 置 了 几 个 自动 装配 的 特殊 规则 

beanFactory.registerResolvableDependency(BeanFactory.c 
lass, beanFactory); 

beanFactory.registerResolvableDependency(ResourceLoade 
r.class, this); 

beanFactory.registerResolvableDependency(ApplicationEv 
entPublisher.class, this); 

beanFactory.registerResolvableDependency(ApplicationCo 
ntext.class, this); 





// 增 加 对 AspectJ 的 支持 
if (beanFactory.containsBean(LOAD TIME WEAVER BEAN NAM 
E)) { 
beanFactory.addBeanPostProcessor(new LoadTimeWeave 
rAwareProcessor(beanFactory)); 
// Set a temporary ClassLoader for type matching. 


beanFactory.setTempClassLoader(new ContextTypeMatc 
hClassLoader (beanFactory. getBeanClassLoader())); 


j 


// 添 加 默认 的 系统 环境 bean 
if (!beanFactory.containsLocalBean(ENVIRONMENT BEAN NA 





ME)) { 
beanFactory.registerSingleton(ENVIRONMENT BEAN NAM 
E, getEnvironment()); 


} 
if (!beanFactory.containsLocalBean(SYSTEM PROPERTIES B 
EAN NAME)) { 
beanFactory.registerSingleton(SYSTEM PROPERTIES BE 
AN NAME, getEnvironment(). getSystemProperties()); 
} 
if (!beanFactory.containsLocalBean(SYSTEM ENVIRONMENT 
BEAN NAME)) { 
beanFactory.registerSingleton(SYSTEM ENVIRONMENT B 
EAN NAME, getEnvironment(). 
getSystemEnvironment()); 


j 





上 面 函 数 中 主要 进行 了 几 个 方面 的 扩展 。 





。 增 加 对 SpEL 语 言 的 支持 。 

。 增 加 对 属性 编辑 器 的 支持 。 

。 增 加 对 一 些 内 置 类 ， 比 如 EnvironmentAware、 
MessageSourceAware 的 信息 注入 。 

。 设 置 了 依赖 功能 可 急 略 的 接口 。 

。 注 册 一 些 固定 依赖 的 属性 。 

e BUT Aspect Hse #4 (会 在 第 7 章 中 进行 详细 的 讲 
解 ) 。 

。 将 相关 环境 变量 及 属性 注册 以 单 例 模式 注册 。 


可 能 读者 不 是 很 理解 每 个 步骤 的 具体 人 台 义 ， 接 
下 来 我 们 会 对 各 个 步骤 进行 详细 地 分 析 。 


6.5.1 增加 SpEL 语 言 的 支持 


Spring 表达 式 语 言 全 称 为 Spring Expression 
Language, 48S NSpEL, XF Struts 2x 中 使 用 的 
OGNL 表 达 式 语言 ， 能 在 运行 时 构建 复杂 表达 式 、 
存 取 对 象 图 属性 、 对 象 方法 调用 等 ， 并 且 能 与 
Spring 功 能 完美 整合 ， 比 如 能 用 来 配置 bean 定 义 。 
他 模块 ， 可 以 单独 使 用 。 


SpEL 使 用 #{...} 作 为 定 界 符 ， 所 有 在 大 框 号 中 
的 字符 都 将 被 认为 是 SpEL， 使 用 格式 如 下 ; 





«bean id="saxophone" valuez'com.xxx.xxx.Xxx'/» 
«bean » 

«property name="instrument" value="#{saxophone}"/> 
<bean/> 


«bean id="Saxophone" value="Ccom. Xxx.XXX.XxXx"/> 
<bean > 


<property name="instrument" ref="saxophone"/> 
<bean/> 





当然 ， 上 面具 是 列举 了 其 中 最 简单 的 使 用 方 
式 ，SpEL 马 能 非 钊 强大， 使 用 好 可 以 大 大 提高 开 及 
效率 ， 这 里 只 为 唤起 读者 的 记忆 来 帮助 我 们 理解 源 
码 ， 有 兴趣 的 读者 可 以 进一步 深入 研究 。 


在 源码 中 通过 代码 
beanFactory.setBeanExpressionResolver(new 
StandardBeanExpression- Resolver()) 注 册 语 言 解析 
厂 ， 就 可 以 对 SpEL 进 行 解 林 了， 那么 在 注册 解析 需 
后 Spring 义 是 在 什么 时 候 调 用 这 个 解析 器 进行 解析 
NE? 


之 前 我 们 讲解 过 Spring 在 bean 进 行 初 始 化 的 时 
候 会 有 属性 填充 的 一 步 ， 而 在 这 一 步 中 Spring 会 调 
用 AbstractAutowireCapableBeanFactory 类 的 
applyPropertyValues 函 数 来 完成 功能 。 就 在 这 个 函 
数 中 ， 会 通过 构造 BeanDefinitionValueResolver 类 型 
实例 valueResolver 来 进行 属性 值 的 解析 。 同 时 ， 也 
是 在 这 个 步骤 中 一 般 通 过 AbstractBeanFactory 中 的 
evaluateBeanDefinitionString 方 法 去 完成 SpEL 的 解 
析 。 








protected Object evaluateBeanDefinitionString(String value, Bea 
nDefinition beanDefinition) { 
if (this.beanExpressionResolver == null) { 
return value; 


} 
Scope scope = (beanDefinition !- null ? getRegisteredS 
cope(beanDefinition.getScope()) : null); 


return this.beanExpressionResolver.evaluate(value, new 
BeanExpressionContext(this, scope)); 
} 


当 调 用 这 个 方法 时 会 判断 是 否 存 在 语言 解析 

EE MIA FE CEJU VI H E eR a 的 方法 进行 解析 ， 
解析 的 过 程 是 n rane 内 ， 这 里 不 
做 过 多 解释 。 我 们 人 通过 查看 对 evaluate- 
BeanDefinitionString 方 法 HUS FH EX RI WG, M 
FACE e RET ES LH] E E CE RT FORTE A bean f] 
时 候 ， 以 及 在 完成 bean 的 初始 化 和 属性 获取 后 进行 
属性 填充 的 时 候 。 














6.5.2 ”增加 属性 注册 编辑 需 


在 Spring DI 注 入 的 时 候 可 以 把 普通 属性 注入 进 
来 ， 但 是 像 Date 类 型 就 无 法 被 识别 。 例 如 : 





public class UserManager { 
private Date 


dataValue; 


public Date getDataValue() { 
return dataValue; 


j 


public void setDataValue(Date dataValue) { 
this.dataValue - dataValue; 
} 


public String toString(){ 
return "dataValue: " + dataValue; 


} 
j 





上 面 代码 中 ， 需 要 对 日 期 型 属性 进行 注入 : 


«bean id="userManager" class="com.test.UserManager"> 
«property name="dataValue"> 
<value>2013-03-15</value> 
</property> 
</bean> 





MNAI: 


QTest 
public void testDate(){ 

ApplicationContext ctx - new ClassPathXmlApplicationContext 
("beans.xml"); 

UserManager userManager = (UserManager )ctx.getBean("userMan 
ager"); 

System.out.println(userManager); 


j 





如 果 和 直接 这 样 使 用 ， 程 序 则 会 报 异 党 ， 类 型 转 
换 不 成 功 。 因 为 在 UserManager 中 的 dataValue 属 性 
是 Date 类 型 的 ， 而 在 XML 中 配置 的 却 是 String 类 型 
的 ， 所 以 当然 会 报 异常 。 


Spring 针 对 此 问题 提供 了 两 种 解决 办 法 。 


1. [EHI BE XU TIESRAR ds 

EH AE XU EZ as, WK AK 
PropertyEditorSupport， 重 写 setAsText 方 法 ， 有 具体 步 
又 如 下 。 


编写 目 定义 的 属性 编辑 髓 。 


public class DatePropertyEditor extends PropertyEditorSupport 


1 
private String format - "yyyy-MM-dd"; 


public void setFormat(String format) ( 
this.format - format; 


} 
public void setAsText(String arg0) throws IllegalArgumentEx 
ception ( 
System.out.println("argO: " + arg0); 
SimpleDateFormat sdf - new SimpleDateFormat(format); 
try 1 
Date d - sdf.parse(arg0); 
this.setValue(d); 
) catch (ParseException e) ( 
e.printStackTrace(); 





2. 将 目 定 义 属 性 编辑 器 注册 到 Spring 中 。 











«1-- 自 定义 属性 编辑 器 - -> 




















«bean class="org.Springframework.beans.factory.config.CustomEdi 
torConfigurer"> 
<property name="customEditors"> 
<map> 


«entry key="java.util.Date"> 
«bean class-"com.test.DatePropertyEditor"» 
«property name="format" value="yyyy-MM-d 


d"/> 
</bean> 
</entry> 
</map> 
</property> 
</bean> 





在 配置 文件 中 引入 类 型 为 


org.Springframework.beans.factory.config.CustomEdit 





的 bean， 并 在 属性 customEditors 中 加 入 目 定 义 的 属 
性 编辑 器 ， 其 中 key 为 属性 编辑 器 所 对 应 的 类 型 。 
通过 这 样 的 配置 ， 当 Spring 在 注入 bean 的 属性 时 一 
旦 遇 到 了 java.util.Date 类 型 的 属性 会 自动 调用 目 定 
义 的 DatePropertyEditor 解 析 恬 进行 解析 ， 并 用 解析 
结 末 代 蔡 配置 属性 进行 注入 。 





2. YEA Spring H i HY JE TE fin FEAS 
CustomDateEditor 


通过 注册 Spring 自 带 的 属性 编辑 器 
CustomDateEditor， 上 有 具体 步骤 如 下 。 


1. FE UTES FE ae o 








public class DatePropertyEditorRegistrar implements PropertyEdi 


torRegistrar{ 
public void registerCustomEditors(PropertyEditorRegistry r 


egistry) { 
registry.registerCustomEditor(Date.class, new CustomDa 
teEditor 


(new SimpleDateFormat ("yyyy-MM-dd"),true)); 
} 


J 





2. 注册 到 Spring 中 。 











«1-- 注册 Spring 自 带 编辑 器 --> 
«bean class-"org.Springframework.beans.factory.config.Cust 
omEditorConfigurer"> 
<property name="propertyEditorRegistrars"> 
<list> 
<bean class="com.test.DatePropertyEditorRe 























gistrar 


"></bean> 


</list> 
</property> 
</bean> 








通过 在 配置 文件 中 将 自 定 义 的 
DatePropertyEditorRegistrar 注 册 进 入 
org.Springframework. 
beans.factory.config.CustomEditorConfigurer[f)] 
propertyEditorRegistrars 属 性 中 ， 可 以 具有 与 方法 1 
同样 的 效果 。 


我 们 了 解 了 目 定 义 属性 编辑 强 的 使 用 ， 但 是 ， 








似乎 这 与 本 节 中 围绕 的 核心 代码 beanFactory.add- 


PropertyEditorRegistrar(new 
ResourceEditorRegistrar(this, getEnvironment()))Jf- J 
联系 ， 因 为 在 注册 自 定 义 属性 编辑 器 的 时 候 使 用 的 
征 PropertyE ditorRe gistry HJregisterCustomEditor7; 
法 ， 而 这 里 使 用 的 是 
ConfigurableListableBeanFactory 的 
addPropertyEditorRegistrar 方 法 。 我 们 不 妨 深入 探索 
一 下 ResourceEditorRegistrar 的 内 部 实现 ， 在 
ResourceEditorRegistrar 中 ， 我 们 最 关心 的 方法 是 
registerCustomEditors 。 











public void registerCustomEditors(PropertyEditorRegistry regist 


ry) i 


ResourceEditor baseEditor - new ResourceEditor(this.re 
sourceLoader, this. 
propertyResolver); 

doRegisterEditor(registry, Resource.class, baseEditor) 
, 

doRegisterEditor(registry, ContextResource.class, base 
Editor); 

doRegisterEditor(registry, InputStream.class, new Inpu 
tStreamEditor(baseEditor)); 

doRegisterEditor(registry, InputSource.class, new Inpu 
tSourceEditor(baseEditor)); 

doRegisterEditor(registry, File.class, new FileEditor( 
baseEditor)); 

doRegisterEditor(registry, URL.class, new URLEditor(ba 
seEditor)); 


ClassLoader classLoader - this.resourceLoader.getClass 
Loader(); 

doRegisterEditor(registry, URI.class, new URIEditor(cl 
assLoader)); 

doRegisterEditor(registry, Class.class, new ClassEdito 
r(classLoader)); 


doRegisterEditor(registry, Class[].class, new ClassArr 
ayEditor(classLoader)); 


if (this.resourceLoader instanceof ResourcePatternReso 
lver) { 
doRegisterEditor(registry, Resource[].class, 
new ResourceArrayPropertyEditor((ResourceP 
atternResolver) this. 
resourceLoader, this.propertyResolver)); 


j 
j 


private void doRegisterEditor(PropertyEditorRegistry registry, 
Class<?> requiredType, PropertyEditor editor) { 
if (registry instanceof PropertyEditorRegistrySupport ) 
{ 


((PropertyEditorRegistrySupport) registry).overrid 
eDefaultEditor (requiredType, 
editor); 


} 
else ( 
registry 
.registerCustomEditor 


(requiredType, editor); 
} 


} 








在 doRegisterEditor 函 数 中 ， 可 以 看 到 在 之 前 提 





到 的 目 定 义 属 性 中 使 用 的 关键 代码 : 
registry.registerCustomEditor(requiredType, editor); 
回 过 头 来 看 ResourceEditorRegistrar 类 的 
registerCustomEditors 方 法 的 核心 功能 ， 其 实 无 非 是 
注册 了 一 系列 的 弟 用 类 型 的 属性 编辑 器 ， 例 如 ， 代 
f3doRegisterEditor(registry, Class.class, new 


ClassEditor(classLoader)) E IN B5] 27] B& slo EVE JJ] Class 
类 对 应 的 属性 编辑 器 。 那 么 ， 注 册 后 ， 一 旦 某 个 实 
体 bean 中 存在 一 些 Class 类 型 的 属性 ， 那 么 Spring 会 
调用 ClassEditor 将 配置 中 定义 的 String 类 型 转换 为 
Class 类 型 并 进行 赋值 。 


分 析 到 这 里 ， 我 们 不 葵 有 个 疑问 ， 虽 说 
ResourceEditorRegistrar 关 的 registerCustomEditors 方 
法 实现 了 批量 注册 的 功能 ， 但 是 
beanFactory.addPropertyEditorRegistrar(new 
ResourceEditorRegistrar(this, getEnvironment())){X fX. 
是 注册 了 ResourceEditorRegistrar 实 例 ， 却 并 没有 调 
用 ResourceEditorRegistrar 的 registerCustomEditors 方 
法 进行 注册 ， 那 么 到 底 是 在 什么 时 候 进 行 注册 的 
呢 ? 进一步 查看 ResourceEditorRegistrar 的 
registerCustomEditors 方 法 的 调用 层次 结构 ， 如 图 6- 
1 所 示 。 


© registerCustomEditors(PropertyEditorRegistry) : void - orc 








org.springframework.beans.support.ResourceEditorRegistra 
© registerCustomEditors(PropertyEditorRegistry) : void - org.springframework.beans.factory.support.AbstractB eanFactory 


图 6-1  ResourceEditorRegistrarll'JregisterCustomEditors77 12; [f 
调用 层次 结构 


发 现在 AbstractBeanFactory 中 的 
registerCustomEditors 方 法 中 被 调用 过 ， 继 续 查 看 
AbstractBeanFactory 中 的 registerCustomEditors 方 法 





的 调用 层次 结构 ， 如 图 6-2 所 示 。 


4 © registerCustomEditors(PropertyEditorRegistry) : void - org: springframework.beans.factory.support.AbstractB eanFactory 
© copyRegisteredEditorsTo me ope BOUE rRegi (i org.springframework.beans.factory.supportAbstractB eanFactory 
o ge tTypeConverter( : Ty nverter - org. gframework.beans.factory.support.AbstractB eanFactory 
© initBbeanWrapper(BeanWrapper) : org.spr ww ramework.beans.factory.support.AbstractB eanFactory 


图 6-2 AbstractBeanFactory 中 的 registerCustomEditors 方 法 的 调 
用 层次 结构 


其 中 我 们 看 到 一 个 方法 是 我 们 熟悉 的 ， 就 是 
AbstractBeanFactory2 中 的 initBeanWrapper 方 法 ， 

这 是 在 bean 初 始 化 时 使 用 的 一 个 方法 ， 之 前 已 经 使 
用 过 大 量 的 篇 幅 进 行 讲 解 ， 主 要 是 在 将 
BeanDefinition 转 换 为 BeanWrapper 后 用 于 对 属性 的 
填充 。 到 此 ， 人 逻辑 已 经 明了 ， 在 bean 的 初始 化 后 会 
Val HJ ResourceEditorRegistrarf]registerCustomEditors 
TIRET tHe I ETE. VEN, FE 
属性 填充 的 环节 便 可 以 直接 让 Spring 使 用 这 些 编辑 
费 进 行 属性 的 解析 了 。 


既然 提 到 了 BeanWrapper， 这 里 也 有 必要 强调 
下 ，Spring 中 用 于 封装 bean 的 是 BeanWrapper 类 型 ， 
而 它 又 间接 继承 了 PropertyEditorRegistry 类 型 ， 也 
就 是 我 们 之 前 反复 看 到 的 方法 参数 
PropertyEditorRegistry registry， 其 实 大 部 分 情况 下 
都 是 BeanWrapper， 对 于 BeanWrapper 在 Spring 中 的 
默认 实现 是 BeanWrapperImpl， 了 而 BeanWrapperImpl 








除了 实现 BeanWrapper 接 口外 还 继承 了 
PropertyEditorRegistrySupport， 在 


PropertyEditorRegistrySupport 中 有 这 样 一 个 方法 : 





private void createDefaultEditors() (1 


this.defaultEditors 
itor>(64); 


= new HashMap<Class<?>, PropertyEd 


// Simple editors, without parameterization capabiliti 


es. 
// The JDK does not 
f these target types. 


this.defaultEditors. 


or()); 
); 


ditor()); 


this.defaultEditors. 


this.defaultEditors. 


this.defaultEditors. 


itor()); 


this.defaultEditors. 
this.defaultEditors. 


reamEditor()); 


this.defaultEditors. 


urceEditor()); 


this.defaultEditors. 


0); 
or()); 


esEditor()); 


this.defaultEditors. 


this.defaultEditors. 


this.defaultEditors. 


ArrayPropertyEditor()); 


this.defaultEditors. 


itor()); 


this.defaultEditors. 
this.defaultEditors. 
this.defaultEditors. 


contain a default editor for any o 
put(Charset.class, new CharsetEdit 
put(Class.class, new ClassEditor() 
put(Class[].class, new ClassArrayE 
put(Currency.class, new CurrencyEd 


put(File.class, 
put(InputStream.class, 


new FileEditor()); 
new Inputst 


put(InputSource.class, new InputSo 


put(Locale.class, new LocaleEditor 


put(Pattern.class, new PatternEdit 


put(Properties.class, new Properti 


put(Resource[].class, new Resource 


put(TimeZone.class, new TimezoneEd 
put(URI.class, 
put(URL.class, 
put(UUID.class, 


new URIEditor()); 
new URLEditor()); 
new UUIDEditor()); 


// Default instances of collection editors. 
// Can be overridden by registering custom instances o 


f those as custom editors. 


this.defaultEditors.put(Collection.class,new CustomCol 
lectionEditor(Collection. class)); 

this.defaultEditors.put(Set.class, new CustomCollectio 
nEditor(Set.class)); 

this.defaultEditors.put(SortedSet.class, new CustomCol 
lectionEditor (SortedSet. class)); 

this.defaultEditors.put(List.class, new CustomCollecti 
onEditor(List.class)); 

this.defaultEditors.put(SortedMap.class, new CustomMap 
Editor(SortedMap.class)); 


// Default editors for primitive arrays. 

this.defaultEditors.put(byte[].class, new ByteArrayPro 
pertyEditor()); 

this.defaultEditors.put(char[].class, new CharArrayPro 
pertyEditor()); 


// The JDK does not contain a default editor for char! 

this.defaultEditors.put(char.class, new CharacterEdito 
r(false)); 

this.defaultEditors.put(Character.class, new Character 
Editor(true)); 


// Spring's CustomBooleanEditor accepts more flag valu 
es than the JDK's default editor. 

this.defaultEditors.put(boolean.class, new CustomBoole 
anEditor(false)); 

this.defaultEditors.put(Boolean.class, new CustomBoole 
anEditor(true)); 


// The JDK does not contain default editors for number 
wrapper types! 

// Override JDK primitive number editors with our own 
CustomNumberEditor. 

this.defaultEditors.put(byte.class, new CustomNumberEd 
itor(Byte.class, false)); 

this.defaultEditors.put(Byte.class, new CustomNumberEd 
itor(Byte.class, true)); 

this.defaultEditors.put(short.class, new CustomNumberE 
ditor(Short.class, false)); 

this.defaultEditors.put(Short.class, new CustomNumberE 
ditor(Short.class, true)); 

this.defaultEditors.put(int.class, new CustomNumberEdi 
tor(Integer.class, false)); 

this.defaultEditors.put(Integer.class, new CustomNumbe 


rEditor(Integer.class, true)); 
this.defaultEditors.put(long.class, new CustomNumberEd 
itor(Long.class, false)); 
this.defaultEditors.put(Long.class, new CustomNumberEd 
itor(Long.class, true)); 
this.defaultEditors.put(float.class, new CustomNumberE 
ditor(Float.class, false)); 
this.defaultEditors.put(Float.class, new CustomNumberE 
ditor(Float.class, true)); 
this.defaultEditors.put(double.class, new CustomNumber 
Editor(Double.class, false)); 
this.defaultEditors.put(Double.class, new CustomNumber 
Editor(Double.class, true)); 
this.defaultEditors.put(BigDecimal.class, new CustomNu 
mberEditor(BigDecimal. class, true)); 
this.defaultEditors.put(BigInteger.class, new CustomNu 
mberEditor(BigInteger. class, true)); 


// Only register config value editors if explicitly re 
quested. 
if (this.configValueEditorsActive) { 
StringArrayPropertyEditor sae = new StringArrayPro 
pertyEditor(); 
this.defaultEditors.put(String[].class, sae); 
this.defaultEditors.put(short[].class, sae); 
this.defaultEditors.put(int[].class, sae); 
this.defaultEditors.put(long[].class, sae); 





具体 的 调用 方法 我 们 就 不 去 深究 了 ， 但 是 至 少 





通过 这 个 方法 我 们 已 经 知道 了 在 Spring 中 定义 了 上 

面 一 系列 常用 的 属性 编辑 器 使 我 们 可 以 方便 地 进行 
配置 。 如 果 我 们 定义 的 bean 中 的 某 个 属性 的 类 型 不 
在 上 面 的 常用 配置 中 的 话 ， 才 需要 我 们 进行 个 性 化 
属性 编辑 器 的 注册 。 








6.5.3 ”添加 
ApplicationContextAwareProcessor 处 理 
c 





了 解 了 属性 编辑 器 的 使 用 后 ， 接 下 来 我 们 继续 
通过 AbstractApplicationContext 的 prepareBean- 
Factory 方 法 的 主线 来 进行 函数 跟踪 。 对 于 
beanFactory.addBeanPostProcessor(new Application- 
ContextAwareProcessor(this)) 其 实 主 要 目的 就 是 注册 
个 BneaPostProcessor， 而 真正 的 逻辑 还 是 在 
ApplicationContextAwareProcessor 中 。 


ApplicationContextAwareProcessor 实 现 
BeanPostProcessor 接 口 ， 我 们 回顾 下 之 前 讲 过 的 内 
容 ， 在 bean 实 例 化 的 时 候 ， 也 天 是 Spring 激活 bean 
的 init-method 的 前 后 ， 会 调用 BeanPost- Processor 的 
postProcessBeforelnitialization 77 72; fl 
postProcessAfterInitialization 方 法 。 同 样 ， 对 于 
ApplicationContextAwareProcessor 我 们 也 关心 这 两 
2 


对 于 postProcessAfterInitialization 方 法 ， 在 
ApplicationContextAwareProcessor 中 并 没有 做 过 多 
逻辑 处 理 。 








public Object postProcessAfterInitialization(Object bean, Strin 
g beanName) { 
return bean; 


j 








那么 ， 我 们 重点 看 一 下 


postProcessBeforeInitialization 方 法 。 





public Object postProcessBeforelnitialization(final Object bean 
, String beanName) throws BeansException { 
AccessControlContext acc - null; 


if (System.getSecurityManager() !- null && 
(bean instanceof EnvironmentAware || bean inst 
anceof EmbeddedValue 
ResolverAware || 
bean instanceof ResourceLoaderAware || 
bean instanceof 
ApplicationEventPublisherAware || 
bean instanceof MessageSourceAware || 
bean instanceof 
ApplicationContextAware)) { 
acc - this.applicationContext.getBeanFactory().get 
AccessControlContext(); 


if (acc !- null) { 
AccessController.doPrivileged(new PrivilegedAction 
<Object>() { 
public Object run() { 
invokeAwareInterfaces 


(bean); 
return null; 


j 


jJ, acc); 


j 


else ( 
invokeAwareInterfaces 


(bean); 


j 


return bean; 


j 


private void invokeAwareInterfaces(Object bean) ( 
if (bean instanceof Aware) { 
if (bean instanceof EnvironmentAware) { 
((EnvironmentAware) bean).setEnvironment(this. 
applicationContext. 
getEnvironment()); 


if (bean instanceof EmbeddedValueResolverAware) { 
((EmbeddedValueResolverAware) bean).setEmbedde 
dValueResolver( 
new EmbeddedValueResolver(this.applica 
tionContext. getBean 
Factory())); 


if (bean instanceof ResourceLoaderAware) { 
((ResourceLoaderAware) bean) .setResourceLoader 
(this.applicationContext); 


if (bean instanceof ApplicationEventPublisherAware 
jx 
((ApplicationEventPublisherAware) bean).setApp 
licationEventPublisher (this.applicationContext); 


if (bean instanceof MessageSourceAware) ( 
((MessageSourceAware) bean).setMessageSource(t 
his.applicationContext); 


if (bean instanceof ApplicationContextAware) { 
((ApplicationContextAware) bean).setApplicatio 
nContext(this. 
applicationContext); 


j 
j 





postProcessBeforelnitialization77 7; P Wal H] T 


invokeA wareInterfaces, /\invokeAwarelnterfaces 7 
法 中 ， 我 们 或 许 已 经 或 多 或 少 了 解 了 Spring 的 用 
意 ， 实 现 这 些 Aware 接 口 的 bean 在 被 初始 化 之 后 ， 
可 以 取得 一 些 对 应 的 资源 。 


6.5.4 ”设置 忽略 依赖 


当 Spring 将 ApplicationContextAwareProcessor 注 
册 后 ， 那 么 在 invokeAwareInterfaces 方 法 中 间接 调 
用 的 Aware 关 已 经 不 是 普通 的 pean f , à 
ResourceLoaderAware. ApplicationEventPublisher 
Aware 等 ， 那 么 当然 需要 在 Spring 做 bean 的 依赖 注入 
的 时 候 忽 略 它 们 。 而 ijgnoreDependencylInterface 的 作 
用 正 是 在 此 。 





// 设 置 了 几 个 忽略 自动 装配 的 接口 
beanFactory.ignoreDependencyInterface(ResourceLoaderAw 

are.class); 
beanFactory.ignoreDependencyInterface(ApplicationEvent 

PublisherAware.class); 
beanFactory.ignoreDependencyInterface(MessageSourceAwa 


re.class); 
beanFactory.ignoreDependencyInterface(ApplicationConte 
xtAware.class); 


beanFactory.ignoreDependencyInterface(EnvironmentAware 
.class); 





6.5.5 ”注册 依赖 


Spring 中 有 了 忽略 依赖 的 功能 ， 当 然 也 必 不 可 
少 地 会 有 注册 依赖 的 功能 。 


beanFactory.registerResolvableDependency(BeanFactory.class, 
beanFactory); 


beanFactory.registerResolvableDependency(ResourceLoade 
r.class, this); 


beanFactory.registerResolvableDependency(ApplicationEv 


entPublisher.class, this); 


beanFactory.registerResolvableDependency(ApplicationCo 
ntext.class, this); 





当 注 册 了 依赖 解析 后 ， 例 如 当 注 册 了 对 
BeanFactory.class 的 解析 依赖 后 ， 当 bean 的 属性 注入 
的 时 候 ， 一 旦 检测 到 属性 为 BeanFactory 类 型 便 会 将 
beanFactory 的 实例 注入 进去 。 


6.6 BeanFactory[ ci Ab FE 


BeanFacotry 作 为 Spring 中 容器 功能 的 基础 ， 用 
于 存放 所 有 已经 加 载 的 bean， 为 了 保证 程序 上 的 高 
可 扩展 性 ，Spring 针 对 BeanFactory 做 了 大 量 的 扩 
展 ， 比 如 我 们 熟知 的 PostProcessor 等 都 是 在 这 里 实 
现 的 。 











6.6.1 ”激活 注册 的 


BeanFactoryPostProcessor 


正式 开始 介绍 之 前 我 们 先 了 解 下 
BeanFactoryPostProcessor 的 用 法 。 


BeanFactoryPostProcessor 接 口 跟 
BeanPostProcessor 关 似 ， 可 以 对 bean 的 定义 《配置 
元 数据 〉 进 行 处 理 。 也 就 是 说 ，Spring IoC 容 器 多 
许 BeanFactoryPostProcessor 在 容器 实际 实例 化 任何 
其 他 的 bean 之 前 读 取 配置 元 数据 ， 并 有 可 能 修改 
它 。 如 果 你 愿意 ， 你 可 以 配置 多 个 
BeanFactoryPostProcessor。 你 还 能 通过 设 
置 “order” 属 性 来 控制 BeanFactoryPostProcessor 的 执 
fTUX FF. X 2A BeanFactoryPostProcessorS Jl, f 
Ordered 接 口 时 你 才 可 以 设置 此 属性 ， 因 此 在 实现 
BeanFactoryPostProcessor 时 ， 束 应 当 考 虑 实现 
Ordered 接 口 ) 。 请 参考 BeanFactoryPostProcessor 和 
Ordered 接 口 的 JavaDoc 以 获取 更 详细 的 信息 。 


如 果 你 想 改 变 实际 的 bean 实 例 〈 例 如 从 配置 元 
数据 创建 的 对 象 )， 那 么 你 最 好 使 用 
BeanPostProcessor。 同 样 地 ， 
BeanFactoryPostProcessorf] fE H 35i yu. il ce AAS 2 
的 。 它 只 和 你 所 使 用 的 容器 有 关 。 如 果 你 在 容器 中 
定义 一 个 BeanFactoryPostProcessor， 它 仅仅 对 此 容 
器 中 的 bean 进 行 后 置 处 理 。 
BeanFactoryPostProcessor 个 会 对 定义 在 男 一 个 容器 
中 的 bean 进 行 后 置 处 理 ， 即 使 这 两 个 容器 都 是 在 同 














一 层次 上 。 在 Spring 中 存在 对 于 
BeanFactoryPostProcessor 的 典型 应 用 ， 比 如 
PropertyPlaceholderConfigurer。 


1. BeanFactoryPostProcessor 的 典型 应 用 : 
PropertyPlaceholderConfigurer 


有 时 候 ， 阅 读 Spring 的 Bean 描 述 文 件 时 ， 你 也 
许 会 遇 到 类 似 如 下 的 一 些 配置 : 


«bean id="message" class="distConfig.HelloMessage"> 
<property name="mes"> 
<value>${bean.message}</value> 


</property> 
</bean> 





其 中 竟然 出 现 了 变量 引用 : ${bean.message} . 
这 就 是 Spring 的 分 散 配 置 ， 可 以 在 另外 的 配置 文件 
中 为 bean.message 指 定 值 。 如 在 bean.property 配 置 如 
PEX: 


bean.message=Hi,can you find me? 


当 访 问 名 为 message 的 bean 时 ，mes 属 性 就 会 被 
置 为 字符 串 “ Hi,can you find me?”， 但 Spring 框架 是 
怎么 知道 存在 这 样 的 配置 文件 呢 ? 这 就 要 靠 
PropertyPlaceholderConfigurer 这 个 类 的 bean: 








«bean id="mesHandler" class="org.Springframework.beans.factory. 
config. Property Placeholder 
Configurer"> 
«property name="locations"> 
<list> 


<value>config/bean.properties</value> 
</list> 
</property> 
</bean> 





在 这 个 bean 中 指定 了 配置 文件 为 
config/bean.properties。 到 这 里 似乎 找到 问题 的 答 守 
了 ， 但 是 其 实 还 有 个 问题 。 这 个 “mesHandler” 只 不 
过 是 Spring 框架 管理 的 一 个 bean， 并 没有 被 别 的 
bean 或 者 对 象 引 用 ，Spring 的 beanFactory 是 怎么 知 
道 要 从 这 个 bean 中 获取 配置 信息 的 呢 ? 


合 看 层级 结构 可 以 看 出 
PropertyPlaceholderConfigurer 这 个 类 间接 继承 了 
BeanFactory- PostProcessor 接 口 。 这 是 一 个 很 特别 
的 接口 ， 当 Spring 加 载 任何 实现 了 这 个 接口 的 bean 
的 配置 时 ， 都 会 在 bean 工 厂 载 入 所 有 bean 的 配置 之 
后 执行 postProcessBeanFactory 方 法 。 在 
PropertyResourceConfigurer 类 中 实现 了 
postProcessBeanFactory 方 法 ， 在 方法 中 先后 调用 了 
mergeProperties 、convertProperties、 
processProperties 这 3 个 方法 ， 分 别 得 到 配置 ， 将 得 
到 的 配置 转换 为 合适 的 类 型 ， 最 后 将 配置 内 容 告 知 


BeanFactory. 























正 是 通过 实现 BeanFactoryPostProcessor 接 口 ， 
BeanFactory 会 在 实例 化 任何 bean 之 前 获得 配置 信 
恩 ， 从 而 能 够 正确 解析 bean 摘 述 文件 中 的 变量 引 
用 。 








2. 使 用 目 定 义 BeanFactoryPostProcessor 


我 们 以 实现 一 个 BeanFactoryPostProcessor， 去 
除 潜在 的 “ 注 谍 ”属性 值 的 功能 来 展示 目 定 义 
BeanFactoryPostProcessor 的 创建 及 使 用 ， 例 如 bean 
定义 中 留 下 bollocks 这 样 的 字眼 。 


配置 文件 BeanFactory.xml 








<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.Springframework.org/schema/beans 


http://www.Springframework.org/schema/beans/Spring-beans.xsd 


"5 
<bean id="bfpp" class="com.Spring.ch04.0bscenityRemovingBeanFac 
toryPostProcessor"> 
«property name="obscenties"> 
<set> 
<value>bollocks</value> 
<value>winky</value> 
<value>bum</value> 
<value>Microsoft</value> 
</set> 
</property> 


</bean> 
<bean id="simpleBean" class="com.Spring.ch04.SimplePostProcesso 


r"> 
<property name="connectionString" value="bollocks"/> 
<property name="password" value="imaginecup"/> 
<property name="username" value="Microsoft"/> 


</bean> 


</beans> 





ObscenityRemovingBeanFactoryPostProcessor.java 





public class ObscenityRemovingBeanFactoryPostProcessor implemen 
ts 


BeanFactoryPostProcessor ( 

private Set«String» obscenties; 

public ObscenityRemovingBeanFactoryPostProcessor()( 
this.obscenties-new HashSet<String>(); 

} 

public void postProcessBeanFactory( 

ConfigurableListableBeanFactory beanFactory) throws 
BeansException { 

String[] beanNames=beanFactory.getBeanDefinitionNames( ) 


for(String beanName:beanNames) { 
BeanDefinition bd=beanFactory.getBeanDefinition(bea 


nName) ; 
StringValueResolver valueResover=new StringValueRes 
olver() { 
public String resolveStringValue(String strVal) 
{ 


if(isObscene(strVal)) return "*****"; 
return strVal; 


} 
}; 
BeanDefinitionVisitor visitor=new BeanDefinitionVis 
itor(valueResover); 
visitor.visitBeanDefinition(bd); 


} 
} 
public boolean isObscene(Object value)t{ 
String potentialObscenity-value.toString().toUpperCase( 


); 


return this.obscenties.contains(potentialObscenity); 


public void setObscenties(Set«String» obscenties) { 
this.obscenties.clear(); 
for(String obscenity:obscenties) { 
this.obscenties.add(obscenity.toUpperCase()); 





执行 类 : 


public class PropertyConfigurerDemo { 
public static void main(String[] args) { 


ConfigurableListableBeanFactory bf=new XmlBeanFactory(n 
ew ClassPathResource ("/META-INF/BeanFactory.xml")); 


BeanFactoryPostProcessor bfpp=(BeanFactoryPostProcessor 
)bf.getBean("bfpp"); 

bfpp.postProcessBeanFactory(bf); 

System.out.println(bf.getBean("simpleBean")); 





输出 结果 : 


SimplePostProcessor{connectionString=*****, username=*****, passw 
ord=imaginecup 





ObscenityRemovingBeanFactoryPostProcessor Spring 


很 好 地 实现 了 屏蔽 掉 obscenties 定 义 的 不 应 该 展示 的 
属性 。 


3. 激活 BeanFactoryPostProcessor 


了 解 了 BeanFactoryPostProcessor 的 用 法 后 便 可 
以 深入 研究 BeanFactoryPostProcessor 的 调用 过 程 
le 





protected void invokeBeanFactoryPostProcessors(ConfigurableList 
ableBeanFactory beanFactory) { 
// Invoke BeanDefinitionRegistryPostProcessors first, 


if any. 
Set<String> processedBeans = new HashSet<String>(); 
// 对 BeanDefinitionRegistry 类 型 的 处 理 
if (beanFactory instanceof BeanDefinitionRegistry) { 
BeanDefinitionRegistry registry = (BeanDefinitionR 
egistry) beanFactory; 

















List<BeanFactoryPostProcessor> regularPostProcesso 
rs = new LinkedList 
«BeanFactoryPostProcessor»(); 

/** 

* BeanDefinitionRegistryPostProcessor 
*/ 

List<BeanDefinitionRegistryPostProcessor> registry 
PostProcessors = new 
LinkedList<BeanDefinitionRegistryPostProcessor>(); 

/* 

* 硬 编码 注册 的 后 处 理 器 
*/ 

















for (BeanFactoryPostProcessor postProcessor : getB 
eanFactoryPostProcessors()) { 
if (postProcessor instanceof BeanDefinitionReg 
istryPostProcessor) { 
BeanDefinitionRegistryPostProcessor regist 
ryPostProcessor =(Bean 
DefinitionRegistryPostProcessor) postProcessor; 


//*] T BeanDefinitionRegistryPostProcessor25 
型 ， 在 BeanFactoryPostProcessor 的 基础 上 还 有 自己 定义 的 方法 ， 需 要 先 调用 

registryPostProcessor.postProcessBeanDefin 
itionRegistry(registry); 

registryPostProcessors.add(registryPostPro 























cessor); 
jelse ( 
/ /Ai3k i$ XiBeanFactoryPostProcessor 
regularPostProcessors.add(postProcessor); 



































} 
} 
Ps 
* 配置 注册 的 后 处 理 器 
*/ 


Map<String, BeanDefinitionRegistryPostProcessor» b 
eanMap - beanFactory. 
getBeansOfType(BeanDefinitionRegistryPostProcessor.class, true, 

false); 

List<BeanDefinitionRegistryPostProcessor> registry 
PostProcessorBeans - new ArrayList«BeanDefinitionRegistryPo 
stProcessor»(beanMap.values()); 

OrderComparator.sort(registryPostProcessorBeans); 

for (BeanDefinitionRegistryPostProcessor postProce 
ssor : registryPostProcessorBeans) ( 

//BeanDefinitionRegistryPostProcessor Hy EP At Fi 
postProcessor.postProcessBeanDefinitionRegistr 























H 


y(registry); 





// 激 活 postProcessBeanFactory 方 法 ， 之 前 激活 的 是 postProc 
essBeanDefinitionRegistry 

/ / hE RES vt ELI BeanDefinitionRegistryPostProcessor 

invokeBeanFactoryPostProcessors(registryPostProces 
sors, beanFactory); 

//Rli&WBeanDefinitionRegistryPostProcessor 

invokeBeanFactoryPostProcessors(registryPostProces 
sorBeans, beanFactory); 

//'$dBeanFactoryPostProcessor 

invokeBeanFactoryPostProcessors(regularPostProcess 
ors, beanFactory); 

processedBeans.addAll(beanMap.keySet()); 

















j 


else ( 
// Invoke factory processors registered with the c 
ontext instance. 


invokeBeanFactoryPostProcessors(getBeanFactoryPost 
Processors(), beanFactory); 





























// 对 于 配置 中 读 取 的 BeanFactoryPostProcessor 的 处 理 
String[] postProcessorNames = beanFactory.getBeanNames 
ForType(BeanFactoryPost Processor.class, true, false); 





List<BeanFactoryPostProcessor> priorityOrderedPostProc 
essors = new ArrayList <BeanFactoryPostProcessor>(); 
List<String> orderedPostProcessorNames = new ArrayList 
<String>(); 
List<String> nonOrderedPostProcessorNames = new ArrayL 
ist<String>(); 
// 对 后 处 理 器 进行 分 类 
for (String ppName : postProcessorNames) { 
if (processedBeans.contains(ppName)) { 
// 已 经 处 理 过 
}else if (isTypeMatch(ppName, PriorityOrdered.clas 












































s)) 1 


priorityOrderedPostProcessors.add(beanFactory. 
getBean(ppName, BeanFactoryPostProcessor.class)); 
jelse if (isTypeMatch(ppName, Ordered.class)) { 
orderedPostProcessorNames.add(ppName); 
jelse ( 
nonOrderedPostProcessorNames.add(ppName); 


j 
j 


// 按 照 优 先 级 进行 排序 

OrderComparator.sort(priorityOrderedPostProcessors); 

invokeBeanFactoryPostProcessors(priorityOrderedPostPro 
cessors, beanFactory); 


// Next, invoke the BeanFactoryPostProcessors that imp 
lement Ordered. 

List«BeanFactoryPostProcessor» orderedPostProcessors - 

new ArrayList«BeanFactory PostProcessor»(); 

for (String postProcessorName : orderedPostProcessorNa 

mes) { 
orderedPostProcessors.add(getBean(postProcessorNam 

e, BeanFactoryPostProcessor. class)); 


} 
// 按 照 order 排 序 
OrderComparator.sort(orderedPostProcessors); 


invokeBeanFactoryPostProcessors(orderedPostProcessors, 
beanFactory); 


// 无 序 ， 直 接 调用 

List«BeanFactoryPostProcessor» nonOrderedPostProcessor 
S = new ArrayList«BeanFactory 
PostProcessor»(); 

for (String postProcessorName : nonOrderedPostProcesso 
rNames) ( 

nonOrderedPostProcessors.add(getBean(postProcessor 

Name, 
BeanFactoryPostProcessor.class)); 


invokeBeanFactoryPostProcessors(nonOrderedPostProcesso 
rs, beanFactory); 





从 上 面 的 方法 中 我 们 看 到 ， 对 于 
BeanFactoryPostProcessor 的 处 理 主要 分 两 种 情况 进 
行 ， 一 个 是 对 于 BeanDefinitionRegistry 类 的 特殊 处 
理 ， 另 一 种 是 对 普通 的 BeanFactoryPostProcessor 进 
行 处 理 。 而 对 于 每 种 情况 都 需要 考虑 便 编码 注入 注 
册 的 后 处 理 硕 以 及 通过 配置 注入 的 后 处 理 需 。 


对 于 BeanDefinitionRegistry 类 型 的 处 理 类 的 处 
理 主 要 包括 以 下 内 容 。 


1. 对 于 便 编 码 注册 的 后 处 理 亏 的 处 理 ， 主 要 


是 通过 AbstractApplicationContext 中 的 添加 处 理 器 方 
法 addBeanFactoryPostProcessor 进 行 添 加 。 


public void addBeanFactoryPostProcessor(BeanFactoryPostProcesso 


r beanFactoryPostProcessor) ( 


this.beanFactoryPostProcessors.add(beanFactoryPostProc 
essor); 





添加 后 的 后 处 理 器 会 存放 在 
beanFactoryPostProcessors 中 ， 而 在 处 理 
BeanFactoryPostProcessor 时 候 会 首先 检测 
beanFactoryPostProcessors 是 个 有 数据 。 当 然 ， 
BeanDefinitionRegistryPostProcessor?f* 7K E] 


BeanFactoryPostProcessor， 不 但 有 
BeanFactoryPostProcessor 的 特性 ， 同 时 还 有 目 己 定 
义 的 个 性 化 方法 ， 也 需要 在 此 调用 。 所 以 ， 这 里 需 
要 从 beanFactoryPostProcessors 中 挑 出 
BeanDefinitionRegistryPostProcessorH) Ja “hee 4s, FF 
it 47 A postProcessBeanDefinitionRegistry FIA I1] X 
活 。 


2. 记录 后 处 理 喜 主要 使 用 了 3 个 List 完 成 。 





e registryPostProcessors: 记录 通过 便 编 码 方式 注 
册 的 BeanDefinitionRegistryPostProcessor 类 型 的 
Sh TE dà o 

e regularPostProcessors: 记录 通过 便 编 码 方式 注册 
HJBeanFactoryPostProcessor2$ 719 HJ Ah FEK 0 

e registryPostProcessorBeans: 记录 通过 配置 方式 
注册 的 BeanDefinitionRegistryPostProcessor 类 型 


HS) MP THES o 


3. 对 以 上 所 记录 的 List 中 的 后 处 理 器 进行 统一 
调用 BeanFactoryPostProcessor 的 
postProcessBeanFactory 方 法 。 


4. 对 beanFactoryPostProcessors 中 非 
BeanDefinitionRegistryPostProcessor 类 型 的 后 处 理 需 
进行 统一 的 BeanFactoryPostProcessor 的 
postProcessBeanFactory 方 法 调用 。 


5. 普通 beanFactory 处 理 。 


BeanDefinitionRegistryPostProcessor 只 对 
BeanDefinitionRegistry 类 型 的 ConfigurableListable- 
BeanFactory 有 效 ， 所 以 如 果 判 断 所 示 的 beanFactory 
并 不 是 BeanDefinitionRegistry， 那 么 便 可 以 忽略 
BeanDefinitionRegistryPostProcessor， 而 直接 处 理 
BeanFactoryPostProcessor， 当 然 获 取 的 方式 与 上 面 
的 获取 类似 。 


这 里 需要 提 到 的 是 ， 对 于 硬 编码 方式 手动 添加 
的 后 处 理 器 是 不 需要 做 任何 排序 的 ， 但 是 在 配置 文 
件 中 读 取 的 处 理 器 ，Sping 并 不 保证 读 取 的 顺序 。 

所 以 ， 为 了 保证 用 户 的 调用 顺序 的 要 求 ，Spring 对 
于 后 处 理 需 的 调用 文 持 按照 PriorityOrdered 或 者 








Ordered HY lit Fe 38] FH « 
6.6.2 ”注册 BeanPostProcessor 


上 文中 提 到 了 BeanFacotoryPostProcessors 的 调 
用 ， 现 在 我 们 来 探索 下 BeanPostProcessor， 但 是 这 
里 并 不 是 调用 ， 而 是 注册 。 真 正 的 调用 其 实 是 在 
bean 的 实例 化 阶段 进行 的 。 这 是 一 个 很 重要 的 步 
又 ， 也 是 很 多 功能 BeanFactory 不 文 持 的 重要 原因 。 
Spring 中 大 部 分 功能 都 是 通过 后 处 理 疾 的 方式 进行 
扩展 的 ， 这 是 Spring 框架 的 一 个 特性 ， 但 是 在 
BeanFactory 中 其 实 并 没有 实现 后 处 理 恬 的 目 动 注 
册 ， 所 以 在 调用 的 时 候 如 果 没 有 进行 手动 注册 其 实 
是 不 能 使 用 的 。 但 是 在 ApplicationContext 中 却 添 加 
了 目 动 注册 功能 ， 如 上 自 定 义 这 样 一 个 后 处 理 需 : 








public class MyInstantiationAwareBeanPostProcessor implements 
InstantiationAwareBean PostProcessor{ 


public Object postProcessBeforeInitialization(Object bean, 
String beanName) 
throws BeansException ( 
System.out.println("---z"); 
return null; 








在 配置 文件 中 添加 配置 : 


«bean class="processors.MyInstantiationAwareBeanPostProcessor" 
/> 





那么 使 用 BeanFactory 方 式 进行 Spring 的 bean 的 
加 载 时 是 不 会 有 任何 改变 的 ， 但 是 使 用 
ApplicationContext 方 式 获 取 bean 的 时 候 会 在 获取 每 
个 bean 时 打印 出 “====”， 而 这 个 特性 就 是 在 
registerBeanPostProcessors 方 法 中 完成 的 。 





我 们 继续 探索 registerBeanPostProcessors 的 方法 
实现 。 





protected void registerBeanPostProcessors(ConfigurableListableB 
eanFactory beanFactory) { 

String[] postProcessorNames = beanFactory.getBeanNames 
ForType(BeanPostProcessor.class, true, false); 









































/* 
* BeanPostProcessorCchecker 是 一 个 普通 的 信息 打印 ， 可 能 会 有 些 
情况 ， 
* 当 Spring 的 配置 中 的 后 处 理 器 还 没有 被 注册 就 已 经 开始 了 bean 的 初始 
化 时 





* 便 会 打印 出 BeanPostProcessorChecker 中 设 定 的 信息 
A 
int beanProcessorTargetCount = beanFactory.getBeanPost 
ProcessorCount() + 1 + postProcessorNames. length; 
beanFactory.addBeanPostProcessor(new BeanPostProcessor 
Checker (beanFactory, 
beanProcessorTargetCount ) ); 











// 使 用 Priorityordered 保 证 顺序 
List«BeanPostProcessor» priorityOrderedPostProcessors 
= new ArrayList<Bean- 
PostProcessor>(); 
//MergedBeanDefinitionPostProcessor 
List<BeanPostProcessor> internalPostProcessors = new A 





rrayList<BeanPost - 
Processor>(); 

// 使 用 0rdered 保 证 顺序 

List<String> orderedPostProcessorNames = new ArrayList 
«String»(); 

//KcF¥BeanPostProcessor 

List<String> nonOrderedPostProcessorNames = new ArrayL 
ist<String>(); 








for (String ppName : postProcessorNames) { 
if (isTypeMatch(ppName, PriorityOrdered.class)) { 
BeanPostProcessor pp - beanFactory.getBean(ppN 
ame, BeanPostProcessor.class); 
priorityOrderedPostProcessors.add(pp); 
if (pp instanceof MergedBeanDefinitionPostProc 
essor) ( 
internalPostProcessors.add(pp); 


jelse if (isTypeMatch(ppName, Ordered.class)) { 
orderedPostProcessorNames.add(ppName) ; 

jelse ( 
nonOrderedPostProcessorNames.add(ppName); 

} 


} 


// 第 1 步 ， 注 册 所 有 实现 Priorityordered 的 BeanPostProcessor 

OrderComparator.sort(priorityOrderedPostProcessors); 

registerBeanPostProcessors(beanFactory, priorityOrdere 
dPostProcessors); 





// 第 2 步 ， 注 册 所 有 实现 O0rdered 的 BeanPostProcessor 
List«BeanPostProcessor» orderedPostProcessors = new Ar 
rayList<BeanPostProcessor>(); 
for (String ppName : orderedPostProcessorNames) { 
BeanPostProcessor pp = beanFactory.getBean(ppName, 
BeanPostProcessor.class); 
orderedPostProcessors.add(pp); 
if (pp instanceof MergedBeanDefinitionPostProcesso 





r) ti 
internalPostProcessors.add(pp); 
} 
} 
OrderComparator.sort(orderedPostProcessors); 


registerBeanPostProcessors(beanFactory, orderedPostPro 
cessors); 





// 第 3 步 ， 注 册 所 有 无 序 的 BeanPostProcessor 
List<BeanPostProcessor> nonOrderedPostProcessors = new 
ArrayList<BeanPost - 
Processor>(); 

for (String ppName : nonOrderedPostProcessorNames) { 

BeanPostProcessor pp = beanFactory.getBean(ppName, 
BeanPostProcessor.class); 

nonOrderedPostProcessors.add(pp); 
if (pp instanceof MergedBeanDefinitionPostProcesso 


r) { 


internalPostProcessors.add(pp); 
} 
} 
registerBeanPostProcessors(beanFactory, nonOrderedPost 
Processors); 





// 第 4 步 ， 注 册 所 有 MergedBeanDefinitionPostProcessor 类 型 的 Be 
anPostProcessor， 并 非 

// 重 复 注 册 ， 

// 在 beanFactory ,addBeanPostProcessor 中 会 先 移 除 已 经 存在 的 Be 
anPostProcessor 

OrderComparator.sort(internalPostProcessors); 

registerBeanPostProcessors(beanFactory, internalPostPr 
ocessors); 


// 添 加 ApplicationListener 探 测 器 
beanFactory.addBeanPostProcessor(new ApplicationListen 
erDetector()); 





配合 源码 以 及 注释 ， 在 
registerBeanPostProcessors 方 法 中 所 做 的 逻辑 相信 大 
家 已 经 很 清楚 了 ， 我 们 再 做 一 下 总 结 。 


首先 我 们 会 发 现 ， 对 于 BeanPostProcessor 的 处 
理 与 BeanFactoryPostProcessor 的 处 理 极为 相似 ， 但 
是 似乎 义 有 些 不 一 样 的 地 方 。 经 过 反复 的 对 比 发 





现 ， 对 于 BeanFactoryPostProcessor 的 处 理 要 区 分 两 
种 情况 ， 一 种 方式 是 通过 硬 编码 方式 的 处 理 ， 另 一 
种 是 通过 配置 文件 方式 的 处 理 。 那 么 为 什么 在 
BeanPostProcessor 的 处 理 中 只 考虑 了 配置 文件 的 方 
式 而 不 考虑 便 编 码 的 方式 呢 ? 提出 这 个 问题 ， 还 是 
因为 读者 没有 完全 理解 两 者 实现 的 功能 。 对 于 
BeanFactoryPostProcessor 的 处 理 ， 不 但 要 实现 注册 
功能 ， 而 且 还 要 实现 对 后 处 理 器 的 激活 操作 ， 上 所 以 
需要 载 入 配置 中 的 定义 ， 并 进行 激活 :而 对 于 
BeanPostProcessor 并 不 需要 马上 调用 ， 再 说 ， 便 编 
码 的 方式 实现 的 功能 是 将 后 处 理 器 提取 并 调用 ， 这 
里 并 不 需要 调用 ， 当 然 不 需要 考虑 便 编 码 的 方式 
了 ， 这 里 的 功能 只 需要 将 配置 文件 的 
BeanPostProcessor 提 取出 来 并 注册 进入 beanFactory 
束 可 以 了 。 


对 于 beanFactory 的 注册 ， 也 不 是 直接 注册 就 可 
以 的 。 在 Spring 中 文 持 对 于 BeanPost- Processor 的 排 
序 ， 比 如 根据 PriorityOrdered 进 行 排序 、 根 据 
Ordered 进 行 排 序 或 者 无 序 ， 而 Spring 在 
BeanPostProcessor 的 激活 顺序 的 时 候 也 会 考虑 对 于 
顺序 的 问题 而 先进 行 排序 。 


这 里 可 能 有 个 地 方 读者 不 是 很 理解 ， 对 于 
internalPostProcessors 中 存储 的 后 处 理 占 也 就 是 
MergedBeanDefinitionPostProcessorZ 7t [f] Ah 3 25 , 





























在 代码 中 似乎 是 被 重复 调用 了， 如: 


for (String ppName : postProcessorNames) { 
if (isTypeMatch(ppName, PriorityOrdered.class)) ( 
BeanPostProcessor pp-beanFactory.getBean(ppNam 
e, BeanPostProcessor.class); 
priorityOrderedPostProcessors.add(pp); 


if (pp instanceof MergedBeanDefinitionPostProc 


internalPostProcessors.add(pp); 


} 
}else if (isTypeMatch(ppName, Ordered.class)) { 
orderedPostProcessorNames.add(ppName); 
yelse ( 
nonOrderedPostProcessorNames.add(ppName); 


j 





其 实 不 是 ， 我 们 可 以 看 看 对 于 
registerBeanPostProcessors 方 法 的 实现 方式 。 








private void registerBeanPostProcessors( 
ConfigurableListableBeanFactory beanFactory, List< 

BeanPostProcessor> 

postProcessors) { 


for (BeanPostProcessor postProcessor : postProcessors) 


beanFactory.addBeanPostProcessor(postProcessor); 
} 
} 
public void addBeanPostProcessor(BeanPostProcessor beanPos 


tProcessor) ( 
Assert.notNull(beanPostProcessor, "BeanPostProcessor m 


ust not be null"); 
this.beanPostProcessors.remove(beanPostProcessor); 


this.beanPostProcessors.add(beanPostProcessor); 


if (beanPostProcessor instanceof InstantiationAwareBea 
nPostProcessor) ( 
this.hasInstantiationAwareBeanPostProcessors - tru 
e; 


if (beanPostProcessor instanceof DestructionAwareBeanP 
ostProcessor) ( 
this.hasDestructionAwareBeanPostProcessors - true; 





可 以 看 到 ， 在 registerBeanPostProcessors 方 法 的 
实现 中 其 实 已 经 确保 了 beanPostProcessor 的 唯一 
性 ， 个 人 猜想 ， 之 所 以 选择 在 
registerBeanPostProcessors 中 没有 进行 重复 移 除 操作 








或 许 是 为 了 保持 分 类 的 效果 ， 使 逻辑 更 为 清晰 吧 。 
6.6.3 JURIH E 0E JS 


在 进行 这 段 函数 的 解析 之 前 ， 我 们 同样 先 来 回 
顾 Spring 国 际 化 的 使 用 方法 。 

假设 我 们 正在 开发 一 修文 繁多 二 语言 的 WebR 
用 程序 ， 要 求 系统 能 够 根据 客户 端的 系统 的 语言 类 





型 返回 对 应 的 界面 : 英文 的 操作 系统 返回 英文 界 
面 ， 而 中 文 的 操作 系统 则 返回 中 文 界 面 一 一 这 便 是 
典型 的 i18n 国 际 化 问题 。 对 于 有 国际 化 要 求 的 应 用 
系统 ， 我 们 不 能 简单 地 采用 硬 编 码 的 方式 编写 用 户 
界面 信息 、 报 错 信息 等 内 容 ， 而 必须 为 这 些 需要 国 
际 化 的 信息 进行 特殊 处 理 。 简 单 来 说 ， 就 是 为 每 种 
语言 提供 一 套 相应 的 资源 文件 ， 并 以 规范 化 命名 的 
方式 保存 在 特定 的 目录 中 ， 由 系统 目 动 根据 客户 端 
语言 选择 适合 的 资源 文件 。 


“国际 化 信息 ”也 称 为 “本 地 化 信息 ”， 一 般 需 要 
两 个 条 件 才 可 以 确定 一 个 特定 类 型 的 本 地 化 信息 ， 
它们 分 别 是 “语言 类 型 * 和 “国家 /地 区 的 类 型 "*。 如 中 
文本 地 化 信息 既 有 中 国 大 陆地 区 的 中 文 ， 又 有 中 国 
台湾 地 区 、 中 国 香港 地 区 的 中 文 ， 还 有 新 加 坡地 区 
的 中 文 。Java 通 过 java.util.Locale 类 表示 一 个 本 地 化 
对 象 ， 它 允许 通过 语言 参数 和 国家 /地 区 参数 创建 一 
个 确定 的 本 地 化 对 象 。 


java.util.Locale 是 表示 语言 和 国家 /地 区 信息 的 
本 地 化 类 ， 它 是 创建 国际 化 应 用 的 基础 。 下 面 给 出 
几 个 创建 本 地 化 对 象 的 示例 : 


























//Q® 带 有 语言 和 国家 /地 区 信息 的 本 地 化 对 象 


Locale locale1 = new Locale("zh","CN"); 














//Q) 只 有 语言 信息 的 本 地 化 对 象 


Locale locale2 = new Locale("zh"); 


//G3) 等 同 于 Locale("zh", "CN") 
Locale locale3 = Locale.CHINA; 


//@ 等 同 于 Locale("zh") 
Locale locale4 = Locale.CHINESE; 





//@ 获取 本 地 系统 默认 的 本 地 化 对 象 
Locale locale 5- Locale.getDefault(); 





JDK 的 java.util 包 中 提供 了 几 个 文 持 本 地 化 的 格 
式 化 操作 工具 类 : NumberFormat. DateFormat, 
MessageFormat， 而 在 Spring 中 的 国际 化 资源 操作 也 
无 非 是 对 于 这 些 类 的 封装 操作 ， 我 们 仅仅 介绍 下 
MessageFormat 的 用 法 以 帮助 大 家 回顾 : 


//Q 岂 信息 格式 化 串 
String patterni = "{O}, WE! 你 于 {4} 在 工商 银行 存 入 {2}》 元 。"; 
String pattern2 = "At {1,time, short} On{1,date, long}, (0) paid { 
2,number, currency}."; 














//G@ 用 于 动态 蔡 换 占 位 符 的 参数 
Object[] params = {"John", new GregorianCalendar().getTime(),1. 
0E3?; 





//@@ 使 用 默认 本 地 化 对 象 格式 化 信息 


String msgi = MessageFormat.format(patterni,params); 


// 田 使 用 指定 的 本 地 化 对 象 格式 化 信息 

MessageFormat mf = new MessageFormat(pattern2,Locale.US); 
String msg2 - mf.format(params); 
System.out.println(msg1); 

System.out.println(msg2); 











Spring 定义 了 访问 国际 化 信息 的 MessageSource 


接口 ， 并 提供 了 几 个 易 用 的 实现 类 。MessageSource 
4] 4l f HierarchicalMessageSource#ll 
ApplicationContext 接 口 扩展 ， 这 里 我 们 主要 看 一 下 
HierarchicalMessageSource 接 口 的 几 个 实现 类 ， 如 图 
6-3 所 示 。 








| al «Java Class» a «Java Class» | 加 «Java Class» 
| © ReloadableResourceBundleMessageSource © ResourceBundleMessageSource | (3 StaticMessageSource | 
sc leitete bolsters, jeans] | B oerte ete rodado inseri | Pitti dette 
A} A} 
SURF? m 
| 加 «Java Class» 加 «Java Class» 
© DelegatingMessageSource © AbstractMessageSource 
EN S E 
Al «Java Interface» 
| Q HierarchicalMessageSource 
a | se» a 


图 6-3 MessageSource 类 图 结构 


HierarchicalMessageSource 接 口 最 重要 的 两 个 实 
现 类 是 ResourceBundleMessageSource 和 
ReloadableResourceBundleMessageSource。 它 们 基 
于 Java 的 ResourceBundle 基 础 类 实现 ， 人 允许 仅 通过 
资源 名 加 载 国际 化 资源 。 


ReloadableResourceBundleMessageSource$i: (/ JE 
时 刷新 功能 ， 人 允许 在 不 重 局 系统 的 情况 下 ， 更 新 资 
源 的 信息 。StaticMessageSource 主 要 用 于 
试 ， 它 允许 通过 编程 的 方式 提供 国际 化 信息 A, 
DelegatingMessageSource 是 为 方便 操作 父 
MessageSource 而 提供 的 代理 类 。 仪 仅 举 例 
ResourceBundleMessageSource 的 实现 方式 。 








1. 定义 资源 文件 


e messages.properties CER: 英文) , 内 容 仅 一 
Gl 如 下 : 


test=test 


e messages zh CN.properties 〈 人 简体 中 文 ) : 


test= 测 试 


然后 cmnd， 打 开 命 令 行 窗口 ， 输 入 native2ascii - 
encoding gbk C:\messages_zh_CN.properties 
C: messages zh CN tem.properties, $=} 
C:\messages_zh_CN_tem.properties # HJ Pj A 4 F FI 
messages zh CN.properties"H, iXfE 
messages zh CN.properties XAF 3. ££ JI jac 1 Jn 
的 内 容 了 ， 比 较 人 简单 。 


2. 定义 配置 文件 


«bean id="messageSource" class="org.Springframework.context.s 
upport.ResourceBundleMessageSource"» 
«property name="basenames"> 
«list» 
<value>test/messages</value> 


</list> 
</property> 
</bean> 





其 中 ， 这 个 Bean 的 ID 必须 命名 为 
messageSource， 人 否则 会 抛 出 
NoSuchMessageException > ^5 © 


3. 使 用 ApplicationContext 访 问 国际 化 信息 


String[] configs = {"applicationContext.xml"}; 
ApplicationContext ctx = new ClassPathXmlApplicationContext(con 
figs); 


// 岂 直接 通过 容器 访问 国际 化 信息 
Object[] params = {"John", new GregorianCalendar().getTime()); 





String stri - ctx.getMessage("test",params,Locale.US); 
String str2 = ctx.getMessage("test", params, Locale.CHINA); 
System.out.println(str1); 

System.out.println(str2); 





J i J Spring Fel by A HS) fs FH Jr BEY EASIER T RT 
的 分 析 了 。 





在 initMessageSource 中 的 方法 主要 功能 是 提取 
配置 中 定义 的 messageSource， 并 将 其 记录 在 Spring 
的 容器 中 ， 也 就 是 AbstractApplicationContext 中 。 当 
然 ， 如 果 用 户 未 设置 资源 文件 的 话 ，Spring 中 也 所 
供 了 默认 的 配置 DelegatingMessageSource。 





在 initMessageSource 中 获取 上 自 定义 资源 文件 的 
方式 为 beanFactory.getBean(MESSAGE_ 
SOURCE BEAN NAME, MessageSource.class)， 在 
这 里 Spring 使 用 了 人 硬 编 但 的 方式 人 硬性 规定 了 子 定义 
资源 文件 必须 为 message， 人 否则 便 会 获取 不 到 目 定 
义 资源 配置 ， 这 也 是 为 什么 之 前 提 到 Bean 的 id 如 采 


部 位 message 会 抛 出 异 第。 





protected void initMessageSource() { 
ConfigurableListableBeanFactory beanFactory = getBeanF 
actory(); 
if (beanFactory.containsLocalBean(MESSAGE SOURCE BEAN 


NAME)) { 


























/V/ 如 果 在 配置 中 已 经 配置 了 messageSource， 那 么 将 messageSou 
rce 提 取 并 记录 在 
//this.messageSource 中 
this.messageSource = beanFactory.getBean(MESSAGE S 
OURCE BEAN NAME, MessageSource. 
class); 
// Make MessageSource aware of parent MessageSourc 
e. 
if (this.parent !- null && this.messageSource inst 
anceof Hierarchical 
MessageSource) ( 
HierarchicalMessageSource hms - (HierarchicalM 
essageSource) this. 
messageSource; 
if (hms.getParentMessageSource() -- null) ( 
hms.setParentMessageSource(getInternalPare 


ntMessageSource( )); 


} 
if (logger.isDebugEnabled()) { 
logger.debug("Using MessageSource [" + this.me 
ssageSource + "]"); 


} 
}else { 
// 如 果 用 户 并 没有 定义 配置 文件 ， 那 么 使 用 临时 的 DelegatingMes 
sageSource 以 便于 作为 调用 
//getMessage 方 法 的 返回 
DelegatingMessageSource dms = new DelegatingMessag 


























eSource(); 
dms.setParentMessageSource(getInternalParentMessag 
eSource( )); 
this.messageSource - dms; 
beanFactory.registerSingleton(MESSAGE SOURCE BEAN . 
NAME, this.messageSource); 
if (logger.isDebugEnabled()) (1 
logger.debug("Unable to locate MessageSource w 
ith name '" + MESSAGE _ 
SOURCE BEAN NAME + 
"'i using default [" + this.messageSou 
rce + e " ) > 


} 





通过 读 取 并 将 和 目 定 义 资源 文件 配置 记录 在 容器 
中 ， 那 么 就 可 以 在 获取 资源 文件 的 时 候 直 接 使 用 
了 了 ， 例 如 ， 在 AbstractApplicationContext 中 的 获取 资 
源 文 件 属 性 的 方法 : 





public String getMessage(String code, Object args[], Locale loc 
ale) throws NoSuchMessage Exception { 
return getMessageSource 


().getMessage(code, args, locale); 


其 中 的 getMessageSource() 方 法 正 是 获取 了 之 前 
定义 的 目 定义 资源 配置 。 


6.6.4 初始 化 
ApplicationEventMulticaster 


FEVERS pring HAY IH] Ped Bi. FRAT EE 
来 看 一 下 Spring 的 事件 监听 的 简单 用 法 。 


1. 定义 监听 事件 


public class TestEvent extends ApplicationEvent { 


public String msg; 


public TestEvent (Object source) { 
super(source); 


public TestEvent (Object source, String msg) { 
super (source); 
this.msg = msg; 


j 


public void print(){ 
System.out.println(msg); 





2. KE LIT ae 


public class TestListener implements ApplicationListener { 


public void onApplicationEvent(ApplicationEvent event) ( 
if(event instanceof TestEvent){ 
TestEvent testEvent = (TestEvent)event; 
testEvent .print(); 





3. USNC TF 


<bean id="testListener" class="com.test.event.TestListener 
"/» 





4. 测试 


public class Test ( 
public static void main(String[] args) { 
ApplicationContext context - new ClassPathXmlApplicatio 
nContext ("classpath: 
applicationContext.xml"); 


TestEvent event = new TestEvent ("hello","msg"); 
context.publishEvent(event); 





当 程 序 运 行 时 ，Spring 会 将 发 出 的 TestEvent 事 
件 转 给 我 们 自 定义 的 TestListener 进行 进一步 处 
理 。 





或 许 很 多 人 一 下 子 会 反映 出 设计 模式 中 的 观察 
者 模式 ， 这 确实 是 个 典型 的 应 用 ， 可 以 在 比较 天 心 
的 事件 结束 后 及 时 处理 。 那 么 我 们 看 看 
ApplicationEventMulticaster 是 如 何 被 初始 化 的 ， 以 
确保 功能 的 正确 运行 。 








initApplicationEventMulticaster 的 方式 比较 简 
单 ， 无 非 考 虑 两 种 情况 。 


。 如 有 条 用户 目 定 义 了 事件 广播 医 ， 那 么 使 用 用 户 
Ae MISE) Fi ar o 

。 WRAP CH Be TE Has, ASA EAL ER 
iAH ApplicationEventMulticaster. 














protected void initApplicationEventMulticaster() { 
ConfigurableListableBeanFactory beanFactory = getBeanF 
actory(); 
if (beanFactory.containsLocalBean(APPLICATION_EVENT_MU 
LTICASTER_BEAN_NAME)) { 
this.applicationEventMulticaster = 
beanFactory.getBean(APPLICATION_EVENT_MULT 


ICASTER_BEAN_NAME, 
ApplicationEventMulticaster.class); 
if (logger.isDebugEnabled()) { 
logger .debug("Using ApplicationEventMulticaste 
r [" + this.application EventMulticaster + "]"); 


} 
jelse ( 


this.applicationEventMulticaster - new SimpleAppli 
cationEventMulticaster 


(beanFactory); 
beanFactory.registerSingleton(APPLICATION EVENT MU 
LTICASTER BEAN NAME, 
this.applicationEventMulticaster); 
if (logger.isDebugEnabled()) { 
logger.debug("Unable to locate ApplicationEven 
tMulticaster with name '" + 


APPLICATION EVENT MULTICASTER BEAN NAM 
E + 


nEventMulticaster + "]"); 


j 


: using default [" + this.applicatio 


j 





FONE AY ST ZA IA Re, RITEN, TEA 
| füd. EEH T a SPE S 8 IIIS] ee ia 
FA ras, ABA ETT ANTHEA AN) 8 a SW, 
SimpleApplicationEventMulticaster¢ — {R 71 Fe « 


其 中 的 一 段 代 码 是 我 们 感 兴趣 的 。 





public void multicastEvent(final ApplicationEvent event) { 
for (final ApplicationListener listener : getApplicati 
onListeners(event)) ( 
Executor executor = getTaskExecutor(); 
if (executor != null) { 
executor.execute(new Runnable() { 
@SuppressWarnings("unchecked" ) 
public void run() { 
listener.onApplicationEvent(event); 


J): 


else ( 
listener.onApplicationEvent(event); 





HY DASE, PrE Spring AF HY [E EA UE 
用 SimpleApplicationEventMulticaster 的 
multicastEvent 来 广播 事件 ， 过 历 所 有 监听 器 ， 并 使 
用 监听 需 中 的 onApplicationEvent 方 法 来 进行 监听 项 
的 处 理 。 而 对 于 每 个 监听 器 来 说 其 实 都 可 以 获取 到 
的 事件 ， 但 是 是 人 否 进行 处 理 则 由 事件 监听 喜来 
决定 。 


6.6.5 YEA A 


Z BjtE4rZüSpringl]) d838H] cm tes] f Sey 
ras, ADA ESpringz379] Ms Ur as HJ EST fx SC (ic p UU 
Wee 4E Be E Mg, ? 





protected void registerListeners() { 
// 硬 编码 方式 注册 的 监听 器 处 理 




















for (ApplicationListener<?> listener : getApplicationL 
isteners()) (1 
getApplicationEventMulticaster().addApplicationLis 
tener(listener); 











} 
// 配 置 文件 注册 的 监听 器 处 理 
String[] listenerBeanNames = getBeanNamesForType(Appli 
cationListener.class, 
true, false); 








for (String lisName : listenerBeanNames) { 
getApplicationEventMulticaster().addApplicationLis 
tenerBean(lisName); 


j 


j 





6.7.4544 dE REXS JU ER HE Pl 


完成 BeanFactory 的 初始 化 工作 ， 其 中 包括 
ConversionServicel] ix E. ACE RGA AE SER JI 
载 的 bean 的 初始 化 工作 。 





protected void finishBeanFactoryInitialization(ConfigurableList 
ableBeanFactory beanFactory) { 

// Initialize conversion service for this context. 

if (beanFactory.containsBean(CONVERSION SERVICE BEAN N 


AME) && 


beanFactory.isTypeMatch(CONVERSION SERVICE BEA 
N NAME, ConversionService 


.class)) { 
beanFactory.setConversionService( 
beanFactory.getBean(CONVERSION SERVICE BEA 
N NAME, ConversionService 


.class)); 


// Initialize LoadTimeWeaverAware beans early to allow 
for registering their 

//transformers early. 

String[] weaverAwareNames - beanFactory.getBeanNamesFo 
rType (LoadTimeweaverAware. class, false, false); 

for (String weaverAwareName : weaverAwareNames) { 

getBean(weaverAwareName); 
} 


// Stop using the temporary ClassLoader for type match 



































m beanFactory.setTempClassLoader(null); 
| // 冻 结 所 有 的 bean 定 义 ， 说 明 注册 的 bean 定 义 将 不 被 修改 或 任何 进一步 
— beanFactory.freezeConfiguration(); 
// Instantiate all remaining (non-lazy-init) singleton 
x // 初 始 化 剩 下 的 单 实例 〈 非 惰性 的 ) 
beanFactory.preInstantiateSingletons(); 





首先 我 们 来 了 解 一 下 ConversionService 类 上 所 提 
供 的 作用 。 


1，ConversionService 的 设置 


之 前 我 们 提 到 过 使 用 上 自 定 义 类 型 转换 磺 从 
String 转 换 为 Date 的 方式 ， 那 么 ， 在 Spring 中 还 提供 
了 男 一 种 转换 方式 : 使 用 Converter。 同 样 ， 我 们 使 
用 一 个 简单 的 示例 来 了 解 下 Converter 的 使 用 方式 。 


1. dE CFR d. 





public class String2DateConverter implements Converter<String, 
Date» ( 


QOverride 
public Date convert(String arg0O) { 


try { 
return DateUtils.parseDate(argO, 


new String[] ( "yyyy-MM-dd HH:mm:ss" }); 
) catch (ParseException e) ( 
return null; 





2. 注册 。 


«bean id="conversionService" 
class="org.Springframework.context.support.ConversionServic 
eFactoryBean"> 
<property name="Cconverters"> 
<list> 
<bean class="String2DateConverter" /> 
</list> 
</property> 
</bean> 





3. 测试 。 


这 样 便 可 以 使 用 Converter 为 我 们 提供 的 功能 
了 ， 下 面 我 们 通过 一 个 人 简便 的 方法 来 对 此 直接 测 
pave 








public void testStringToPhoneNumberConvert() { 
DefaultConversionService conversionService = new DefaultCon 
versionService(); 
conversionService.addConverter(new StringToPhoneNumberConve 


rter()); 


String phoneNumberStr = "010-12345678"; 

PhoneNumberModel phoneNumber = conversionService.convert(ph 
oneNumberStr, 
PhoneNumber Model.class); 


Assert.assertEquals("010", phoneNumber.getAreaCode()); 
} 


通过 以 上 的 功能 我 们 看 到 了 Converter 以 及 
ConversionService 提 供 的 便利 功能 ， 其 中 的 配置 束 
是 在 当前 函数 中 被 初始 化 的 。 








2. 冻结 配置 


冻结 所 有 的 bean 定 义 ， 说 明 注 册 的 bean 定 义 将 
不 被 修改 或 进行 任何 进一步 的 处 理 。 


public void freezeConfiguration() { 
this.configurationFrozen - true; 
synchronized (this.beanDefinitionMap) { 
this.frozenBeanDefinitionNames - StringUtils.toStr 


ingArray(this.bean DefinitionNames); 


j 





3. 初始 化 非 延迟 加 载 





ApplicationContext 实 现 的 默认 行为 就 是 在 局 动 
时 将 所 有 单 例 bean 提 前 进行 实例 化 。 提 前 实例 化 意 
味 看 作为 初始 化 过 程 的 一 部 分 ，ApplicationContext 
实例 会 创建 并 配置 所 有 的 单 例 bean。 通 党 情况 下 这 
是 一 件 好 事 ， 因 为 这 样 在 配置 中 的 任何 错误 就 会 即 





ANBAR CE UI S us RT RE 46 LTD IS JL 
AO 。 而 这 个 实例 化 的 过 程 就 是 在 


finishBeanFactoryInitialization 中 完成 的 。 











public void preInstantiateSingletons() throws BeansException { 
if (this.logger.isInfoEnabled()) ( 
this.logger.info("Pre-instantiating singletons in 


" + this); 
} 
List«String» beanNames; 
synchronized (this.beanDefinitionMap) { 
// Iterate over a copy to allow for init methods w 
hich in turn register 
//new bean definitions. 
// While this may not be part of the regular facto 
ry bootstrap, it does 
//otherwise work fine. 
beanNames = new ArrayList<String>(this.beanDefinit 
ionNames); 
} 
for (String beanName : beanNames) { 
RootBeanDefinition bd = getMergedLocalBeanDefiniti 
on(beanName); 
if (!bd.isAbstract() && bd.isSingleton() && !bd.is 
LazyInit()) { 
if (isFactoryBean(beanName)) (1 
final FactoryBean<?> factory = (FactoryBea 
n<?>) getBean(FACTORY BEAN_ PREFIX + beanName); 
boolean isEagerInit; 
if (System.getSecurityManager() !- null && 
factory instanceof 
SmartFactoryBean) { 
isEagerInit - AccessController.doPrivi 
leged(new PrivilegedAction <Boolean>() ( 
public Boolean run() ( 
return ((SmartFactoryBean<?>) 
factory).isEagerInit(); 


), getAccessControlContext()); 
} 


else ( 
isEagerInit - (factory instanceof Smar 


tFactoryBean && 
((SmartFactoryBean<?>) factory 


).isEagerInit()); 


if (isEagerInit) { 
getBean(beanName); 
} 
} 
else ( 
getBean(beanName); 





6.8 finishRefresh 


在 Spring 中 还 提供 了 Lifecycle 接 口 ，Lifecycle 中 
包含 start/stop 方 法 ， 实 现 此 接口 后 Spring 会 保证 在 
局 动 的 时 候 调 用 其 start 方 法 开始 生命 周期 ， 并 在 
Spring 关闭 的 时 候 调 用 stop 方 法 来 结束 生命 周期 ， 
通常 用 来 配置 后 台 程 序 ， 在 局 动 后 一 直 运 行 〈( 如 对 
MQ 进行 轮 询 等 ) 。 而 ApplicationContext 的 初始 化 
最 后 正 古 保证 了 这 一 功能 的 实现 。 














protected void finishRefresh() { 


initLifecycleProcessor(); 


// Propagate refresh to lifecycle processor first. 
getLifecycleProcessor().onRefresh(); 


// Publish the final event. 
publishEvent(new ContextRefreshedEvent(this)); 


po 
1. initLifecycleProcessor 


当 ApplicationContext 启 动 或 停止 时 ， 它 会 通过 
LifecycleProcessor 来 与 所 有 声明 的 pean 的 周期 做 状 
态 更 新 ， 而 在 LifecycleProcessor 的 使 用 前 首先 需要 
初始 化 。 











protected void initLifecycleProcessor() { 
ConfigurableListableBeanFactory beanFactory = getBeanF 
actory(); 
if (beanFactory.containsLocalBean(LIFECYCLE PROCESSOR 
BEAN NAME)) { 
this.lifecycleProcessor - 
beanFactory.getBean(LIFECYCLE PROCESSOR BE 
AN. NAME, Lifecycle- 
Processor.class); 
if (logger.isDebugEnabled()) (1 
logger.debug("Using LifecycleProcessor [" + th 
is.lifecycleProcessor + "]|"); 
} 
}else { 
DefaultLifecycleProcessor defaultProcessor = new D 
efaultLifecycleProcessor(); 
defaultProcessor.setBeanFactory(beanFactory); 
this.lifecycleProcessor - defaultProcessor; 
beanFactory.registerSingleton(LIFECYCLE PROCESSOR. 
BEAN NAME, this. 
lifecycleProcessor); 
if (logger.isDebugEnabled()) { 
logger .debug("Unable to locate LifecycleProces 
sor with name '" + 
LIFECYCLE_PROCESSOR_BEAN_NAME + 
"': using default [" + this.lifecycleP 
rocessor + "|"); 


2. onRefresh 


启动 所 有 实现 了 Lifecycle 接 口 的 bean。 





public void onRefresh() { 
startBeans(true); 
this.running - true; 


j 


private void startBeans(boolean autoStartupOnly) { 
Map<String, Lifecycle» lifecycleBeans = getLifecycleBe 
ans(); 
Map<Integer, LifecycleGroup> phases = new HashMap<Inte 
ger, LifecycleGroup»(); 
for (Map.Entry<String, ? extends Lifecycle» entry : li 
fecycleBeans.entrySet()) { 
Lifecycle bean - entry.getValue(); 
if (!autoStartupOnly || (bean instanceof SmartLife 
cycle && ((SmartLifecycle) bean).isAutoStartup())) { 
int phase - getPhase(bean); 
LifecycleGroup group - phases.get(phase); 
if (group -- null) ( 
group - new LifecycleGroup(phase, this.tim 
eoutPerShutdownPhase, 
lifecycleBeans, autoStartupOnly); 
phases.put(phase, group); 


group.add(entry.getKey(), bean); 


if (phases.size() > 0) { 
List<Integer> keys = new ArrayList<Integer>(phases 
.keySet()); 
Collections.sort(keys); 
for (Integer key : keys) { 
phases.get(key).start(); 


3. publishEvent 


当 完 成 ApplicationContext 初 始 化 的 时 候 ， 要 通 
过 Spring 中 的 事件 发 布 机 制 来 发 出 Context- 
RefreshedEvent 事 件 ， 以 保证 对 应 的 监听 需 可 以 做 
进一步 的 馆 辑 处 理 。 


public void publishEvent(ApplicationEvent event) { 
Assert.notNull(event, "Event must not be null"); 
if (logger.isTraceEnabled()) ( 
logger.trace("Publishing event in " + getDisplayNa 
me() +": " + event); 


getApplicationEventMulticaster().multicastEvent (event ) 


if (this.parent != null) { 
this.parent.publishEvent(event); 


j 





57% AOP 


我 们 知道 ， 使 用 面 同 对 象 编程 COOP) 有 一 些 
凉 闹 ， 当 需要 为 多 个 不 具有 继承 关系 的 对 象 引 入 同 
一 个 公共 行为 时 ， 例 如 日 志 、 安 全 检测 等 ， 我 们 只 
有 在 每 个 对 象 里 引用 公共 行为 ， 这 样 程序 中 束 产 生 
了 大 量 的 重复 代码 ， 程 序 就 不 便于 维护 了 ， 所 以 就 
有 了 一 个 对 面向 对 象 编程 的 补充 ， 即 面向 方面 编程 
(AOP) ，AOP 所 关注 的 方 同 是 横 同 的 ， 不 同 于 
OOP 的 纵 问 。 


Spring 中 提供 了 AOP 的 实现 ， 但 是 在 低 版 本 
Spring 中 定义 一 个 切面 是 比较 有 奢 烦 的 ， 需 要 实现 特 
定 的 接口 ， 并 进行 一 些 较 为 复杂 的 配置 。 低 版 本 
Spring AOP 的 配置 是 被 批评 最 多 的 地 方 。Spring 上 听 
取 了 这 方面 的 批评 声音 ， 并 下 决心 彻底 改 变 这 一 现 
状 。 在 Spring 2.0 中 ，Spring AOP 已 经 焕然 一 新 ， 你 
可 以 使 用 @AspectJ 注 解 非常 容易 地 定义 一 个 切面 ， 
不 需要 实现 任何 的 接口 。 


Spring 2.0 采 用 @AspectJ 注 解 对 POJO 进 行 标 
注 ， 从 而 定义 一 个 包含 切 点 信息 和 增强 横 切 逻辑 的 
Wi. Spring 2.0 可 以 将 这 个 切面 织 入 到 匹配 的 目标 

















Bean 中 。@AspectJ 注 解 使 用 AspectJ 切 点 表达 式 语 
TATU EM, AW DG) esa. eA. A 
配 符 等 高 级 功能 进行 切 点 定义 ， 拥 有 强大 的 连接 点 
描述 能 力 。 我 们 先 来 直观 地 浏览 一 下 Spring 中 的 
AOP 实 现 。 


7.1 动态 AOP 使 用 示例 


1. 创建 用 于 拦截 的 bean 


在 实际 工作 中 ， 此 bean 可 能 是 满足 业务 需要 的 
核心 逻辑 ， 例 如 test 方 法 中 可 能 会 封装 着 某 个 核心 
业务 ， 但 是 ， 如 果 我 们 想 在 test 前 后 加 入 日 志 来 跟 
踪 调 试 ， 如 果 直 接 修 改 源码 并 不 符合 面 癌 对 象 的 设 
计 方 法 ， 而 且 随 意 改 动 原 有 代码 也 会 造成 一 定 的 风 
险 ， 还 好 接 下 来 的 Spring 帮 我 们 做 到 了 这 一 点 。 











public class TestBeant{ 


private String testStr = "testStr"; 


public String getTestStr() { 
return testStr; 


j 


public void setTestStr(String testStr) ( 
this.testStr = testStr; 
} 


public void test(){ 


System.out.println("test"); 
} 


2. 创建 Advisor 





Spring 中 据 弃 了 最 原始 的 党 杂 配 置 方式 而 采用 
@AspectJ 注 解 对 POJO 进 行 标 注 ， 使 AOP 的 工作 大 
大 简化 ， 例 如 ， 在 AspectUJTest 类 中 ， 我 们 要 做 的 就 
是 在 所 有 类 的 test 方 法 执行 前 在 控制 合 中 打印 
beforeTest， 而 在 所 有 类 的 test 方 法 执行 后 打印 
afterTest， 同 时 叉 使 用 环绕 的 方式 在 所 有 类 的 方法 
执行 前 后 再 次 分 别 打印 before1 和 after1。 














QAspect 
public class AspectJTest ( 


QPointcut("execution(* *.test(..))") 
public void test(){ 


j 


QBefore("test()") 
public void beforeTest(){ 
System.out.println("beforeTest"); 


QAfter("test()") 
public void afterTest(){ 
System.out.println("afterTest"); 


QAround("test()") 
public Object arountTest(ProceedingJoinPoint p){ 
System.out.println("before1"); 


Object o=null; 
try { 
o = p.proceed(); 
} catch (Throwable e) { 
e.printStackTrace(); 
} 


System.out.println("after1"); 
return o; 





3. 创建 配置 文件 


XML 是 Spring 的 基础 。 尽 管 Spring 一 再 简化 配 
置 ， 并 且 大 有 使 用 注解 取代 XML 配置 之 势 ， 但 是 无 
论 如 何 ， 至 少 现在 XML 还 是 Spring 的 基础 。 要 在 
Spring 中 开局 AOP 功 能 ， 还 需要 在 配置 文件 中 作 如 
下 声明 : 





«?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmlns:aop="http://www.Springframework.org/schema/aop" 
xmlns:context="http://www.Springframework.org/schema/c 


ontext" 
XSi:schemaLocation="http://www.Springframework.org/sch 
ema/beans 
http://www. Springframework.org/schema/beans/Sp 
ring-beans-3.0.xsd 


http://www.Springframework.org/schema/aop 

http://www.Springframework.org/schema/aop/Spri 
ng-aop-3.0.xsd 

http://www.Springframework.org/schema/context 

http://www.Springframework.org/schema/context/ 
Spring- context- 3.0.xsd 


Is 
«aop:aspectj-autoproxy /» 


«bean id="test" class="test.TestBean"/> 
<bean class="test.AspectJTest"/> 
</beans> 





4. 测试 


经 过 以 上 步骤 后 ， 便 可 以 验证 Spring 的 AOP 为 
我 们 提供 的 神奇 效果 了 。 


public static void main(String[] args) { 

ApplicationContext bf - new ClassPathXmlApplicationContext 
("aspectTest.xm1"); 

TestBean bean=(TestBean) bf.getBean("test"); 

bean.test(); 





不 出 意外 ， 我 们 会 看 到 控制 台中 打印 了 如 下 代 
fi: 


before1 
test 


afterTest 
after1 





Spring 实 现 了 对 所 有 类 的 test 方 法 进行 增强 ， 使 
辅助 功能 可 以 独立 于 核心 业务 之 外 ， 方 便 与 程序 的 
扩展 和 解 灰 。 
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置 文件 控制 的 ， 也 残 是 <aop:aspectj-autoproxy />， 

当 在 配置 文件 中 声明 了 这 人 句 配 置 的 时 候 ，Spring 吏 
的 AOP， 那 么 我 们 的 分 析 就 从 这 句 注 解 
开始 。 
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之 前 讲 过 Spring 中 的 目 定 义 注解 ， 如 朵 声明 了 
目 定 义 的 注解 ， 那 么 就 一 定 会 在 程序 中 的 某 个 地 方 
注册 了 对 应 的 解析 器 。 我 们 搜索 整个 代码 ， 壬 试 找 
到 注册 的 地 方 ， 全 局 搜索 后 我 们 发 现 了 在 
AopNamespaceHandler 中 对 应 大 这样 一 段 浮 数 : 














public void init() { 
// In 2.0 XSD as well as in 2.1 XSD. 
registerBeanDefinitionParser("config", new ConfigBeanD 
efinitionParser()); 
registerBeanDefinitionParser("aspectj-autoproxy 


", new AspectJAutoProxyBean 

DefinitionParser()); 
registerBeanDefinitionDecorator("scoped-proxy", new Sc 

opedProxyBeanDefinition Decorator()); 


// Only in 2.0 XSD: moved to context namespace as of 2 
ab 

registerBeanDefinitionParser("Spring-configured", new 
SpringConfiguredBean 
DefinitionParser()); 


j 


| 


此 处 不 再 对 Spring 中 的 目 定义 注解 方式 进行 讨 
论 。 有 兴趣 的 读者 可 以 回顾 之 前 的 内 容 。 


我 们 可 以 得 知 ， 在 解析 配置 文件 的 时 候 ， 一 旦 
过 到 aspectj-autoproxy 注 解 时 就 会 使 用 解析 鼎 
AspectJAutoProxyBeanDefinitionParser 进 行 解 析 ， 那 
么 我 们 来 看 一 看 AspectJAutoProxyBean- 
DefinitionParser 的 内 部 实现 。 








7.2.1 注册 
AnnotationAwareAspectJAutoProxyCreato 


所 有 解析 器 ， 因 为 是 对 BeanDefinitionParser 接 
口 的 统一 实现 ， 入 口 都 是 从 parse 函 数 开始 的 ， 
AspectJ AutoProxyBeanDefinitionParserlH parse PK Zt 
如 下 : 





public BeanDefinition parse(Element element, ParserContext pars 
erContext) { 
// 注 册 AnnotationAwareAspectJAutoProxyCreator 
AopNamespaceUtils.registerAspectJAnnotationAutoProxyCr 


eatorIfNecessary 


(parserContext, element); 
// 对 于 注解 中 子 类 的 处 理 


extendBeanDefinition(element, parserContext); 




















return null; 


其 中 


registerAspectJAnnotationAutoProxyCreatorIf Necessar 


ER CEA EGER, BEREE HKI 





/** 


* it/jAnnotationAwareAspect JAutoProxyCreator 
* (param parserContext 
* @param sourceElement 
A 
public static void registerAspectJAnnotationAutoProxyCreatorIfN 
ecessary( 
ParserContext parserContext, Element sourceElement 


Li 





// 注 册 或 升级 AutoProxyCreator 定 义 beanName 为 org.Springframe 
work.aop.config. 
//internalAutoproxyCreator 的 BeanDefinition 


BeanDefinition beanDefinition = AopConfigUtils.registe 
rAspectJAnnotationAuto- ProxyCreatorIfNecessary 


( 
parserContext.getRegistry(), parserContext.ext 
ractSource(sourceElement)); 




















// 对 于 proxy-target-class 以 及 expose-proxy 属 性 的 处 理 
useClassProxyingIfNecessary 





(parserContext.getRegistry(), sourceElement); 




















// 注 册 组 件 并 通知 ， 便 于 监听 器 做 进一步 处 理 

// 其 中 beanDefinition 的 className 为 AnnotationAwareAspectJAutoP 
roxyCreator 

registerComponentIfNecessary(beanDefinition, parserCon 





text); 
} 


MEM 
在 


registerAspectJAnnotationAutoProxyCreatorIf Necessar 
方法 i 主要 完成 了 3 件 事情 ， 基 本 上 每 行 代码 就 是 
一 个 完整 的 逻辑 。 





1. 注册 或 者 升级 


AnnotationAwareAspectJAutoProxyCreator 


对 于 AOP 的 实现 ， 基 本 上 都 是 靠 
AnnotationAwareAspectJAutoProxyCreator 去 完成 ， 
它 可 以 根据 @Point 注 解 定义 的 切 点 来 自动 代理 相 匹 
配 的 bean。 但 是 为 了 配置 简便 ，Spring 使 用 了 目 定 
义 配 置 来 帮助 我 们 自动 注册 
AnnotationAwareAspectUJAutoProxyCreator， 其 注册 
过 程 束 是 在 这 里 实现 的 。 








public static BeanDefinition registerAspectJAnnotationAutoProxy 
CreatorIfNecessary 
(BeanDefinitionRegistry registry, Object source) ( 

return registerOrEscalateApcAsRequired(AnnotationAware 
AspectJAutoProxyCreator 


. class, registry, source); 


j 


private static BeanDefinition registerOrEscalateApcAsRequired(C 

lass cls, BeanDefinition Registry registry, Object source) ( 
Assert.notNull(registry, "BeanDefinitionRegistry must 

not be null"); 

// 如 果 已 经 存在 了 自动 代理 创建 器 且 存 在 的 自动 代理 创建 器 与 现在 的 不 一 致 ， 那 么 需要 















































根据 优先 级 来 判断 到 底 需 要 使 用 哪 

if (registry.containsBeanDefinition(AUTO PROXY CRE 
ATOR BEAN NAME)) ( 

//AUTO PROXY CREATOR BEAN NAME - 

// "org.Springframework.aop.config.inte 
rnalAutoProxyCreator"; 

BeanDefinition apcDefinition - registry.getBeanDef 
inition(AUTO PROXY 
CREATOR BEAN NAME); 


if (!cls.getName().equals(apcDefinition.getBeanCla 
ssName())) { 
int currentPriority - findPriorityForClass(apc 
Definition.getBean 
ClassName()); 
int requiredPriority - findPriorityForClass(cl 


if (currentPriority « requiredPriority) ( 
// 改 变 bean 最 重要 的 就 是 改变 bean 所 对 应 的 className 



































apcDefinition.setBeanClassName(cls.getName 
O); 
} 
} 
// 如 果 已 经 存在 自动 代理 创建 器 并 且 与 将 要 创建 的 一 致 ， 那 么 
无 须 再 次 创建 





return null; 
} 
RootBeanDefinition beanDefinition = new RootBeanDefini 
tion(cls); 
beanDefinition.setSource(source); 
beanDefinition.getPropertyValues().add("order", Ordere 
d.HIGHEST PRECEDENCE 


); 


URE); 


beanDefinition.setRole(BeanDefinition.ROLE INFRASTRUCT 


//AUTO PROXY CREATOR BEAN NAME - 
// "org.Springframework.aop.config.internal 
AutoProxyCreator"; 
registry.registerBeanDefinition(AUTO PROXY CREATOR BEAN 
NAME, beanDefinition); 


return beanDefinition; 


[o 
以 上 代码 中 实现 了 目 动 注册 

AnnotationAwareAspectJAutoProxyCreator 类 有 的 功 

能 ， 同 时 这 里 还 涉及 了 一 个 优先 级 的 问题 ， 如 有 果 已 

经 存在 了 目 动 代 理 创 建 器 ， 而 且 存 在 的 自动 代理 创 

建 句 与 现在 的 不 一 致 ， 那 么 需要 根据 优先 级 来 判断 

到 底 需 要 使 用 哪个 。 











2. 处 理 proxy-target-class 以 及 expose-proxy 属 性 


useClassProxyingIfNecessary 3 Jil 了 proxy-target- 
class 属 性 以 及 expose-proxy 属 性 的 处 理 。 





private static void useClassProxyinglIfNecessary(BeanDefinitionR 


egistry registry, 
Element sourceElement) ( 
if (sourceElement !- null) ( 
// 对 于 proxy-target-class 属 性 的 处 理 
boolean proxyTargetClass = Boolean.valueOf(sourceE 
lement.getAttribute 
(PROXY TARGET CLASS ATTRIBUTE)); 
if (proxyTargetClass) ( 
AopConfigUtils.forceAutoProxyCreatorToUseClass 




















Proxying 


(registry); 











// 对 于 expose-proxy 属 性 的 处 理 
boolean exposeProxy = Boolean.valueOf(sourceElemen 
t.getAttribute (EXPOSE  PROXY ATTRIBUTE)); 
if (exposeProxy) { 
AopConfigUtils.forceAutoProxyCreatorToExposePr 











OXy 
(registry); 


j 
j 


// 强 制 使 用 的 过 程 其 实 也 是 一 个 属性 设置 的 过 程 
public static void forceAutoProxyCreatorToUseClassProxying(Bean 
DefinitionRegistry 
registry) { 
if (registry.containsBeanDefinition(AUTO PROXY CREATOR 

_BEAN_NAME)) { 

BeanDefinition definition = registry.getBeanDefini 
tion(AUTO_PROXY_CREATOR_ BEAN_NAME); 

definition.getPropertyValues().add("proxyTargetCla 
ss", Boolean. TRUE); 


j 














j 


static void forceAutoProxyCreatorToExposeProxy(BeanDefinitionRe 
gistry registry) ( 
if (registry.containsBeanDefinition(AUTO PROXY CREATOR 

BEAN NAME)) { 

BeanDefinition definition - registry.getBeanDefini 
tion(AUTO PROXY CREATOR  BEAN NAME); 

definition.getPropertyValues().add("exposeProxy", 
Boolean.TRUE); 


j 


} 





e proxy-target-class: Spring AOP 部 分 使 用 JDK 动 
态 代理 或 者 CGLIB 来 为 目标 对 象 创建 代 理 〈 建 





议 尽 量 使 用 JDK 的 动态 代理 ) o MRR H 
标 对 象 实 现 了 至 少 一 个 接口 ， 则 会 使 用 JDK 动 态 
代理 。 所 有 该 目标 类 型 实现 的 接口 都 将 被 代 

理 。 奉 该 目标 对 象 没 有 实现 任何 接口 ， 则 创建 


一 个 CGLIB 代 理 。 如 果 你 希望 强制 使 用 CGLIB 
代理 (例如 希望 代理 目标 对 象 的 所 有 方法 ， 而 
不 只 是 实现 犁 接口 的 方法 ) ， 那 也 可 以 。 但 是 
需要 考虑 以 下 两 个 问题 。 

o 无 法 通知 Cadvise) Final 方 法 ， 因 为 它们 不 





。 你 需要 将 CGLIB 二 进 制 发 行 包 放 在 classpath 
ifi. 


EZRA, IDKA atte ge SAS EE, sm] 
使 用 CGLIB 代 理 需 要 将 <aop:config> 的 proxy-target- 
class 必 性 设 为 true: 


«aop:config proxy-target-class="true"> ... </aop:config> 





当 需 要 使 用 CGLIB 代 理 和 @AspectJ 目 动 代理 文 
持 ， 可 以 按照 以 下 方式 设置 <aop:aspectj- 
autoproxy> 的 proxy-target-class 必 性 : 


«aop:aspectj-autoproxy proxy-target-class-"true"/» 
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Fl, The devil is in the details 。 


。JDK 动 态 代理 ， 其 代理 对 象 必须 是 某 个 接口 的 实 
现 ， 它 是 通过 在 运行 期 间 创建 一 个 接口 的 实现 








类 来 完成 对 目标 对 象 的 代理 。 

。CGLIB 代 理 : 实现 原理 类 似 于 JDK 动 态 代理 ， 只 
是 它 在 运行 期 间 生 成 的 代理 对 象 是 针对 目标 类 
扩展 的 子 类 。CGLIB 是 高 效 的 代码 生成 包 ， 瓜 
层 是 依靠 ASM 〈 开 源 的 Java 字 节 码 编辑 类 库 ) 
操作 字 节 码 实 现 的 ， 性 能 比 JDK 强 。 

e expose-proxy: 有 时 候 目 标 对 象 内 部 的 自我 调用 
将 无 法 实施 切面 中 的 增强 ， 如 下 示例 : 

public interface AService { 


public void a(); 
public void b(); 














j 


@Service() 
public class AServiceImpl1 implements AService{ 


@Transactional(propagation = Propagation.REQUIRED) 
public void a() { 
this.b(); 


@Transactional(propagation = Propagation.REQUIRES NEW) 
public void b() { 
} 





此 处 的 this 指 向 目标 对 象 ， 因 此 调用 this.b0 将 
不 会 执行 b 事 务 切 面 ， 即 不 会 执行 事务 增强 ， 因 此 b 
方法 的 事务 定义 “@Transactional(propagation = 
Propagation.REQUIRES_NEW)” 将 不 会 实施 ， 为 了 
解决 这 个 问题 ， 我 们 可 以 这 样 做 : 


«aop:aspectj-autoproxy expose-proxy="true"/> 





MEN 


然后 将 以 上 代码 中 的 “this.b0;” 修 改 
为 “((AService) AopContext.currentProxy()).b();" BẸ 
可 。 通 过 以 上 的 修改 便 可 以 完成 对 a 和 Pb 方法 的 同时 
增强 。 


最 后 注册 组 件 并 通知 ， 便 于 监听 名 做 进一步 处 
理 ， 这 里 束 不 再 一 一 殉 述 了 。 


7.3 创建 AOP 代 理 


上 文中 讲解 了 通过 自 定 义 配置 完成 了 对 
AnnotationAwareAspectJAutoProxy Creator 78 Ef] Éj 
动 注 册 ， 那 么 这 个 类 到 底 做 了 什么 工作 来 完成 AOP 
的 操作 呢 ? 首先 我 们 看 看 Annotation- 
AwareAspectJAutoProxyCreator 类 的 层次 结构 ， 如 图 
7-1 所 示 。 








«^ [Ht El ~ 
4 x9 Annotation AwareAspectlAutoProxyCreator 
4 9 Aspect/AwareAdvisorAutoProxyCreator 
4 (9^ AbstractAdvisorAutoProxyCreator 
E 9^ AbstractAutoProxyCreator 
4 (9 ProxyConfig 
(9 Objec 
© Serializable 
AoplnfrastructureB ean 
BeanClassLoaderAware 
@ Aware 
BeanFactoryAware 
@ Aware 
Ordered 


SmartinstantiationAwareB eanPostProcessor 


.990 © QOO 


© Instantiation&wareBeanPostProcessor 


(9 BeanPostProcessor 








图 7-1 AnnotationAwareAspectJAutoProxyCreator 类 的 层次 结构 


在 类 的 层级 中 ， 我 们 看 到 
AnnotationAwareAspectJAutoProxyCreator 实 现 了 
BeanPostProcessor 接 口 ， 而 实现 BeanPostProcessor 
后 ， 当 Spring 加 载 这 个 Bean 时 会 在 实例 化 前 调用 其 
postProcess- AfterInitialization 方 法 ， 而 我 们 对 于 
AOP 逻 辑 的 分 析 也 由 此 开始 。 


在 父 类 AbstractAutoProxyCreator 的 
postProcessAfterInitialization 中 代码 如 下 : 


public Object postProcessAfterInitialization(Object bean, Strin 
g beanName) throws 


BeansException ( 
if (bean != null) { 
// 根 据 给 定 的 bean 的 class 和 name 构 建 出 一 个 key， 格 式 : beanCl 
assName beanName 
Object cacheKey - getCacheKey(bean.getClass(), bea 








nName); 
if (!this.earlyProxyReferences.contains(cacheKey)) 


{ 























// 如 果 它 适合 被 代理 , 则 需要 封装 指定 bean 
return wrapIfNecessary 








(bean, beanName, cacheKey); 


j 
j 


return bean; 


j 


protected Object wrapIfNecessary(Object bean, String beanName, 
Object cacheKey) ( 
// 如 果 已 经 处 理 过 
if (this.targetSourcedBeans.contains(beanName)) { 
return bean; 























} 

// 无 须 增强 

if (this.nonAdvisedBeans.contains(cachekey)) { 
return bean; 






































} 
// 给 定 的 bean 类 是 否 代表 一 个 基础 设施 类 ， 基 础 设施 类 不 应 代理 , 或 者 配置 了 指 
定 bean 不 需要 自动 代理 
if (isInfrastructureClass(bean.getClass()) || shouldSk 
ip(bean.getClass(), beanName)) ( 
this.nonAdvisedBeans.add(cacheKey); 
return bean; 















































i 


// 如 果 存 在 增强 方法 则 创建 代理 
Object[] specificInterceptors = getAdvicesAndAdvisorsF 























orBean 


(bean.getClass(), beanName, null); 
// 如 果 获 取 到 了 增强 则 需要 针对 增强 创建 代理 
if (SpecificInterceptors !- DO NOT PROXY) ( 
this.advisedBeans.add(cacheKey); 
// fi e 
Object proxy - createProxy 



























































(bean.getClass(), beanName, specificInterceptors, 

new SingletonTargetSource(bean)); 
this.proxyTypes.put(cacheKey, proxy.getClass()); 
return proxy; 


j 


this.nonAdvisedBeans.add(cacheKey); 
return bean; 
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然 ， 真 正 开 始 之 前 还 需要 经 过 一 些 判断 ， 比 如 有 是 个 
己 经 处 理 过 或 者 是 人 否 是 需要 跳 过 的 bean， 而 真正 创 
建 代 理 的 代码 是 从 getAdvicesAnd- AdvisorsForBean 
开始 的 。 


创建 代理 主要 包含 了 两 个 步 又。 








1. 获取 增强 方法 或 者 增强 人 项。 
2. 根据 获取 的 增强 进行 代理 。 
Eo 032 3 EJ ESTE FF E Fd 7-2 AIT AB - 


© Property:«Java ClasssAbstractAutoProxyCreator 


1: postPro focesteriniiaization 


les 1.1: getCacheKey 








= (771 12: getCacheKey 
La |13: wrapIf Necessary 


LJ 1.3.1: getAdvicesAndAdvisorsF orBean 





| ATE ' 1.3.2: getAdvicesAndAdvisorsForBean 


1.3.3: createProxy 





E 1.3.4: createProxy 





ist ew a 


2: postP idceseiibednibializalon 


图 7-2  AbstractAutoProxyCreatorf']postProcessA fterInitialization 
函数 执行 时 序 图 


虽然 看 似 简 单 ， 但 是 每 个 步骤 中 都 经 历 了 大 量 


逻辑 。 站 和 完 来 看 看 获取 增强 方法 的 实现 远 
Ho 








QOverride 


protected Object[] getAdvicesAndAdvisorsForBean(Class beanClass 
, String beanName, 


TargetSource targetSource) ( 
List advisors - findEligibleAdvisors 


(beanClass, beanName); 
if (advisors.isEmpty()) ( 
return DO NOT PROXY; 


return advisors.toArray(); 


j 


protected List«Advisor» findEligibleAdvisors(Class beanClass, S 
tring beanName) { 
List<Advisor> candidateAdvisors = findCandidateAdvisors 


List<Advisor> eligibleAdvisors = findAdvisorsThatCanAp 


(candidateAdvisors, beanClass, beanName); 
extendAdvisors(eligibleAdvisors); 
if (!eligibleAdvisors.isEmpty()) ( 
eligibleAdvisors - sortAdvisors(eligibleAdvisors); 


return eligibleAdvisors; 








对 于 指定 bean 的 增强 方法 的 获取 一 定 是 包含 两 





个 步骤 的 ， 获 取 所 有 的 增强 以 及 寻找 所 有 增强 中 适 
用 于 bean 的 增强 并 应 用 ， 那 么 findCandidateAdvisors 
与 findAdvisorsThatCanApply 便 是 做 了 这 两 件 事情 。 
当然 ， 如 果 无 法 找到 对 应 的 增强 器 便 返 回 
DO_NOT_PROXY， 其 中 DO_NOT_PROXY=null。 


7.3.1 ”获取 增强 此 


由 于 我 们 分 析 的 是 使 用 注解 进行 的 AOP， 上 所 以 
对 于 findCandidateAdvisors 的 实现 其 实 是 由 
AnnotationAwareAspectJAutoProxyCreator 类 完成 
的 ， 我 们 继续 跟踪 AnnotationAwareAspectJAuto- 
ProxyCreator 的 findCandidateAdvisors 方 法 。 








@Override 

protected List<Advisor> findCandidateAdvisors() { 
// 当 使 用 注解 方式 配置 AOP 的 时 候 并 不 是 丢弃 了 对 XML 配置 的 支持 ， 
// 在 这 里 调用 父 类 方法 加 载 配置 文件 中 的 AOP 声 明 
List<Advisor> advisors = super.findCandidateAdvisors() 












































// Build Advisors for all AspectJ aspects in the bean 
factory. 


advisors.addAll(this.aspectJAdvisorsBuilder.buildAspec 
tJAdvisors()); 


return advisors; 
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继承 了 AbstractAdvisorAutoProxyCreator， 在 实现 获 
取 增 强 的 方法 中 除了 保留 父 类 的 获取 配置 文件 中 定 
义 的 增强 外 ， 同 时 添加 了 获取 Bean 的 注解 增强 的 功 
能 ， 那 么 其 实现 正 是 由 
this.aspectJAdvisorsBuilder.buildAspectJAdvisors()K 
实现 的 。 








在 真正 研究 代码 之 前 读者 可 以 符 试 看 目 己 去 想 
象 一 下 解析 思路 ， 看 看 目 己 的 实现 与 Spring 是 合 








FEF We? RARI BERN AT Xo R T fi PR BX 
Fete AMD RETES EA n] VATE SK A SEB 
EET HE, BAe aA EK. 


1. 获取 所 有 beanName， 这 一 步骤 中 所 有 在 
beanFacotry 中 注册 的 bean 都 会 被 提取 出 来 。 


2. WJ Pt beanName, 34K H FS BH Aspect: 
解 的 类 ， 进 行进 一 步 的 处 理 。 


3. 对 标记 为 AspectJ 注 解 的 类 进行 增强 占 的 所 




















取 。 
4. 将 提取 结果 加 入 缓存 。 


现在 我 们 来 看 看 函数 实现 ， 对 Spring 中 所 有 的 
类 进行 分 析 ， 提 取 Advisor。 





public List<Advisor> buildAspectJAdvisors() { 
List<String> aspectNames = null; 


synchronized (this) { 
aspectNames - this.aspectBeanNames; 
if (aspectNames -- null) ( 
List<Advisor> advisors = new LinkedList<Adviso 
r>(); 
aspectNames = new LinkedList<String>(); 
// 获 取 所 有 的 beanName 
String[] beanNames -BeanFactoryUtils.beanNames 
ForTypeIncludingAncestors 
(this.beanFactory, Object.class, true, false); 
// 循 环 所 有 的 beanName 找 出 对 应 的 增强 方法 


for (String beanName : beanNames) { 

















beanName ) ; 


) i 


a(beanType, beanName) 











// 不 合法 的 bean 则 略 过 ， 由 子 类 定义 规则， 默认 返回 tru 

















if (!isEligibleBean(beanName)) { 
continue; 


} 
// 获 取 对 应 的 bean 的 类 型 
Class beanType = this.beanFactory.getType( 


if (beanType == null) { 
continue; 


} 
// 如 果 存 在 Aspect 注 解 
if (this.advisorFactory.isAspect(beanType) 





aspectNames.add(beanName) ; 
AspectMetadata amd = new AspectMetadat 
/ 


if (amd.getAjType().getPerClause().get 


Kind() -- PerClauseKind. SINGLETON) ( 


factory - 
nceFactory(this.bean- 


Factory, beanName); 


.advisorFactory. 
getAdvisors(factory); 


eanName)) { 


e, classAdvisors); 


anName, factory); 


eanName)) (1 


MetadataAwareAspectInstanceFactory 


new BeanFactoryAspectInsta 

















// 解 析 标 记 AspectJ 注 解 中 的 增强 方法 
List<Advisor> classAdvisors = this 


if (this.beanFactory.isSingleton(b 
this.advisorsCache.put(beanNam 


j 


else ( 
this.aspectFactoryCache.put(be 


} 

advisors.addAll(classAdvisors); 
jelse ( 

// Per target or per this. 

if (this.beanFactory.isSingleton(b 


throw new IllegalArgumentExcep 


tion("Bean with name '" + beanName + 
"' is a singleton, but 
aspect instantiation 
model is not singleton"); 
} 
MetadataAwareAspectInstanceFactory 
factory - 
new PrototypeAspectInstanc 
eFactory(this. 
beanFactory, beanName); 
this.aspectFactoryCache.put(beanNa 
me, factory); 
advisors.addAll(this.advisorFactor 
y.getAdvisors(factory)); 


j 
j 


this.aspectBeanNames - aspectNames; 
return advisors; 


i 


if (aspectNames.isEmpty()) { 
return Collections.EMPTY LIST; 


j 


// 记 录 在 缓存 中 
List<Advisor> advisors = new LinkedList<Advisor>(); 
for (String aspectName : aspectNames) { 
List<Advisor> cachedAdvisors = this.advisorsCache. 
get(aspectName); 
if (cachedAdvisors !- null) ( 
advisors.addAll(cachedAdvisors); 
else ( 
MetadataAwareAspectInstanceFactory factory - t 
his.aspectFactoryCache. get(aspectName); 
advisors.addAll(this.advisorFactory.getAdvisor 
s(factory)); 


j 


j 


return advisors; 








至 此 ， 我 们 已 经 完成 了 Advisor 的 提取 ， 在 上 面 
的 步骤 中 最 为 重要 也 最 为 楷 杂 的 就 是 增强 左 的 获 
取 。 而 这 一 功能 委托 给 了 getAdvisors 方 法 去 实现 
(this.advisorFactory.getAdvisors(factory) ) . 





public List<Advisor> getAdvisors(MetadataAwareAspectInstanceFac 
tory maaif) { 

// 获 取 标 记 为 AspectJ 的 类 

final Class<?> aspectClass = maaif.getAspectMetadata() 
.getAspectClass(); 

// 获 取 标 记 为 AspectJ 的 name 

final String aspectName = maaif.getAspectMetadata().ge 
tAspectName( ); 

// 验 证 

validate(aspectClass); 





final MetadataAwareAspectInstanceFactory lazySingleton 
AspectInstanceFactory -new LazySingletonAspectInstanceFactoryDe 
corator(maaif); 


final List«Advisor» advisors - new LinkedList«Advisor» 


0; 
ReflectionUtils.doWithMethods(aspectClass, new Reflect 
ionUtils.MethodCallback() { 
public void doWith(Method method) throws IllegalAr 
gumentException { 
// 声 明 为 Pointcut 的 方法 不 处 理 
if (AnnotationUtils.getAnnotation(method, Poin 
tcut.class) -- null) ( 
Advisor advisor - getAdvisor 























(method, lazySingletonAspectInstance Factory, advisors.size(), 
aspectName); 
if (advisor !- null) { 
advisors.add(advisor); 


j 


} 
J): 


if (!advisors.isEmpty() && lazySingletonAspectInstance 


Factory.getAspect Metadata().isLazilyInstantiated()) { 
// 如 果 寻 找 的 增强 器 不 为 空 而 且 又 配置 了 增强 延迟 初始 化 ， 那 么 需要 
在 首位 加 入 同步 实例 化 增强 器 
Advisor instantiationAdvisor = new SyntheticInstan 
tiationAdvisor (lazySingleton- AspectInstanceFactory ) ; 
advisors.add(0, instantiationAdvisor); 
} 


// 获 取 DeclareParents 注 解 
for (Field field : aspectClass.getDeclaredFields()) { 
Advisor advisor - getDeclareParentsAdvisor(field); 
if (advisor !- null) { 
advisors.add(advisor); 












































j 
j 


return advisors; 
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注解 以 及 根据 注解 生成 增强 的 步 又， 然后 考 夸 到 在 
配置 中 可 能 会 将 增强 配置 成 延迟 初始 化 ， 那 么 需要 











在 首位 加 入 同步 实例 化 增强 器 以 保证 增强 使 用 之 前 
的 实例 化 ， 最 后 是 对 DeclareParents 注 解 的 获取 ， 下 
面 将 详细 介绍 一 下 每 个 步骤 。 


1. 普通 增强 器 的 获取 
普通 增强 器 的 获取 过 辑 通 过 getAdvisor 方 法 实 


现 ， 实 现 步骤 包括 对 切 点 的 注解 的 获取 以 及 根据 注 
解 信息 生成 增强 。 


public Advisor getAdvisor(Method candidateAdviceMethod, Metadat 
aAwareAspectInstanceFactory aif, 
int declarationOrderInAspect, String aspectName) { 


validate(aif.getAspectMetadata().getAspectClass()); 
// 切 点 信息 的 获取 
AspectJExpressionPointcut ajexp = 

getPointcut 





(candidateAdviceMethod, aif.getAspectMetadata().getAspectClass( 
)); 
if (ajexp == null) { 
return null; 








I 
// 根 据 切 点 信息 生成 增强 器 


return new InstantiationModelAwarePointcutAdvisorImpl 


( 
this, ajexp, aif, candidateAdviceMethod, decla 

rationOrderInAspect, 

aspectName); 


j 














1. 切 点 信息 的 获取 。 所 谓 获 取 切 点 信息 就 古 
指定 注解 的 表达 式 信息 的 获取 ， 如 
@Before("test()"). 








private AspectJExpressionPointcut getPointcut(Method candidateA 
dviceMethod, Class<?> 
candidateAspectClass) { 
// 获 取 方 法 上 的 注解 
AspectJAnnotation<?> aspectJAnnotation = 
AbstractAspectJAdvisorFactory.findAspectJAnnot 








ationOnMethod 


(candidateAdviceMethod); 
if (aspectJAnnotation -- null) ( 
return null; 


j 


// 使 用 AspectJExpressionPointcut 实 例 封装 获取 的 信息 
AspectJExpressionPointcut ajexp = 
new AspectJExpressionPointcut(candidateAspectC 
lass, new String[0], 
new Class[0]); 
// 提 取得 到 的 注解 中 的 表达 式 ， 如 : 
//QPointcut("execution(* *.*test*(..))") 中 的 execution(* 
*,*test*(..)) 
ajexp.setExpression(aspectJAnnotation.getPointcutExpressio 


n()); 
} 











return ajexp; 


protected static AspectJAnnotation findAspectJAnnotationOnMetho 
d(Method method) { 

// 设 置 敏感 的 注解 类 

Class<? extends Annotation>[] classesToLookFor = new C 





lass[] ( 

Before.class, Around.class, After.class, After 
Returning.class, 
AfterThrowing.class, Pointcut.class 


for (Class«? extends Annotation» c : classesToLookFor) 
AspectJAnnotation foundAnnotation - findAnnotation 


(method, c); 
if (foundAnnotation !- null) ( 
return foundAnnotation; 
} 
上 


return null; 





} 
// 获 取 指 定 方法 上 的 注解 并 使 用 AspectJAnnotation 封 装 
private static <A extends Annotation> AspectJAnnotation<A> find 
Annotation(Method 
method, Class<A> toLookFor) { 
A result = AnnotationUtils.findAnnotation(method, toLo 








okFor); 
if (result !- null) ( 
return new AspectJAnnotation«A»(result); 
} 
else { 
return null; 


2. 根据 切 点 信息 生成 增强 。 所 有 的 增强 都 由 
Advisor 的 实现 类 InstantiationModelAware- 
PointcutAdvisorImpl 统 一 封装 的 。 





public InstantiationModelAwarePointcutAdvisorImpl(AspectJAdviso 
rFactory af,  AspectJ 
ExpressionPointcut ajexp, 

MetadataAwareAspectInstanceFactory aif, Method me 
thod, int declaration 
OrderInAspect, String aspectName) { 


//test() 

this.declaredPointcut - ajexp; 

//public void test.AspectJTest.beforeTest() 
this.method - method; 


this.atAspectJAdvisorFactory - af; 


this.aspectInstanceFactory - aif; 

//0 

this.declarationOrder - declarationOrderInAspect; 
//test.AspectJTest 

this.aspectName = aspectName; 


if (aif.getAspectMetadata().isLazilyInstantiated()) { 
// Static part of the pointcut is a lazy type. 
Pointcut preInstantiationPointcut = 
Pointcuts.union(aif.getAspectMetadata().ge 
tPerClausePointcut(), 
this.declaredPointcut); 


this.pointcut - new PerTargetInstantiationModelPoi 
ntcut(this.declaredPointcut, 
prelnstantiationPointcut, aif); 
this.lazy - true; 
jelse ( 


// A singleton aspect. 
this.instantiatedAdvice - instantiateAdvice 


(this.declaredPointcut); 
this.pointcut - declaredPointcut; 
this.lazy - false; 
} 





在 封装 过 程 中 只 是 简单 地 将 信息 封装 在 类 的 实 





例 中 ， 所 有 的 信息 单纯 地 赋值 ， 在 实例 初始 化 的 过 
程 中 还 完成 了 对 于 增强 器 的 初始 化 。 因 为 不 同 的 增 
强 所 体现 的 逻辑 是 不 同 的 ， 比 如 

@Before (“test()”) 与 @After (“test()”) 标签 的 不 
同 束 是 增强 痴 增强 的 位 置 不 同 ， 所 以 束 需 要 不 同 的 
增强 占 来 完成 不 同 的 逻辑 ， 而 根据 注解 中 的 信息 初 
始 化 对 应 的 增强 器 束 是 在 instantiateAdvice 孙 数 中 实 
现 的 。 




















private Advice instantiateAdvice(AspectJExpressionPointcut pcut 


) i 


return this.atAspectJAdvisorFactory.getAdvice 


( 
this.method, pcut, this.aspectInstanceFactory, 
this.declarationOrder, this.aspectName); 


public Advice getAdvice(Method candidateAdviceMethod, AspectJEx 
pressionPointcut ajexp, 

MetadataAwareAspectlInstanceFactory aif, int declar 
ationOrderInAspect, 
String aspectName) { 


Class<?> candidateAspectClass = aif.getAspectMetadata( 
).getAspectClass(); 


validate(candidateAspectClass); 


AspectJAnnotation«?» aspectJAnnotation = 
AbstractAspectJAdvisorFactory.findAspectJAnnot 
ationOnMethod (candidate 
AdviceMethod); 
if (aspectJAnnotation -- null) ( 
return null; 


j 


// If we get here, we know we have an AspectJ method. 
// Check that it's an AspectJ-annotated class 
if (!isAspect(candidateAspectClass)) { 
throw new AopConfigException("Advice must be decla 
red inside an aspect type: " + 
"Offending method '" + candidateAdviceMeth 
od + "' in class [" + 
candidateAspectClass.getName() + "]"); 


} 


if (logger.isDebugEnabled()) { 
logger .debug( "Found AspectJ method: " + candidateA 
dviceMethod); 


} 


AbstractAspectJAdvice SpringAdvice; 

// 根 据 不 同 的 注解 类 型 封装 不 同 的 增强 器 

switch (aspectJAnnotation.getAnnotationType()) { 
case AtBefore 











SpringAdvice - new AspectJMethodBeforeAdvice 


(candidateAdviceMethod, ajexp, aif); 
break; 
case AtAfter 


SpringAdvice - new AspectJAfterAdvice 
(candidateAdviceMethod, ajexp, aif); 


break; 
case AtAfterReturning 


SpringAdvice - new AspectJAfterReturningAdvice 


(candidateAdviceMethod, ajexp, aif); 

AfterReturning afterReturningAnnotation - (Aft 
erReturning) aspectJAnnotation. 
getAnnotation(); 

if (StringUtils.hasText(afterReturningAnnotati 
on.returning())) { 

SpringAdvice.setReturningName(afterReturni 

ngAnnotation.returning()); 

} 

break; 

case AtAfterThrowing 


SpringAdvice = new AspectJAfterThrowingAdvice 


(candidateAdviceMethod, ajexp, aif); 
AfterThrowing afterThrowingAnnotation - (After 
Throwing) aspectJAnnotation. 
getAnnotation(); 
if (StringUtils.hasText(afterThrowingAnnotatio 
n.throwing())) ( 
SpringAdvice.setThrowingName(afterThrowing 
Annotation.throwing()); 
} 
break; 
case AtAround 


SpringAdvice = new AspectJAroundAdvice 


(candidateAdviceMethod, ajexp, aif); 
break; 
case AtPointcut: 
if (logger.isDebugEnabled()) { 


logger.debug("Processing pointcut '" + can 
didateAdviceMethod. getName() + "'"); 
j 
return null; 
default: 


throw new UnsupportedOperationException( 
"Unsupported advice type on method " + 
candidateAdviceMethod); 


j 


// Now to configure the advice... 
SpringAdvice.setAspectName(aspectName) ; 
SpringAdvice.setDeclarationOrder(declarationOrderInAsp 
ect); 
String[] argNames - this.parameterNameDiscoverer.getPa 
rameterNames 
(candidateAdvice Method); 
if (argNames != null) { 
SpringAdvice.setArgumentNamesFromStringArray(argNa 


mes); 
} 
SpringAdvice.calculateArgumentBindings(); 
return SpringAdvice; 

} 








从 函数 中 可 以 看 到 ，Spring 会 根据 不 同 的 注解 





生成 不 同 的 增强 器 ， 例 如 AtBefore 会 对 应 
AspectJMethodBeforeAdvice， 而 在 
AspectJMethodBeforeAdvice 中 完成 了 增强 方法 的 逻 
Eo PAT Se lor it LA as FS ge a SL o 


e MethodBeforeAdviceInterceptor. 


我 们 首先 查看 MethodBeforeAdviceInterceptor 类 
的 内 部 实现 。 





public class MethodBeforeAdviceInterceptor implements MethodInt 
erceptor, Serializable ( 


private MethodBeforeAdvice advice; 


fre 


* Create a new MethodBeforeAdviceInterceptor for the give 
n advice. 


* (param advice the MethodBeforeAdvice to wrap 
*/ 
public MethodBeforeAdvicelInterceptor(MethodBeforeAdvice ad 
vice) { 
Assert.notNull(advice, "Advice must not be null"); 
this.advice - advice; 


} 
public Object invoke(MethodInvocation mi) throws Throwable 


this.advice.before 


(mi.getMethod(), mi.getArguments(), mi.getThis() ); 
return mi.proceed(); 
} 





其 中 的 属性 MethodBeforeAdvice 代 表 着 前 置 增 
"EJ AspectJMethodBeforeAdvice, Eixbefore 7 
法 : 





public void before(Method method, Object[] args, Object target) 
throws Throwable ( 
invokeAdviceMethod 


(getJoinPointMatch(), null, null); 
} 


protected Object invokeAdviceMethod(JoinPointMatch jpMatch, Obj 
ect returnValue, 
Throwable ex) throws Throwable { 

return invokeAdviceMethodWithGivenArgs 


(argBinding(getJoinPoint(), jpMatch, 
returnValue, ex)); 


j 


protected Object invokeAdviceMethodWithGivenArgs(Object[] args) 


throws Throwable ( 
Object[] actualArgs - args; 
if (this.aspectJAdviceMethod.getParameterTypes().lengt 
h == 0) { 
actualArgs = null; 
} 
try { 
ReflectionUtils.makeAccessible(this.aspectJAdviceM 
ethod); 








// 激 活 增强 方法 
return this.aspectJAdviceMethod.invoke(this.aspect 
InstanceFactory. getAspect Instance(), actualArgs); 





catch (IllegalArgumentException ex) { 
throw new AopInvocationException("Mismatch on argu 
ments to advice method [" + 
this.aspectJAdviceMethod + "]; pointcut ex 
pression [" + 
this.pointcut.getPointcutExpression() + "] 


y ex) 


catch (InvocationTargetException ex) ( 
throw ex.getTargetException(); 


j 








invokeAdviceMethodWithGivenArgs7] 1; HY 
aspectJAdviceMethod 正 是 对 于 前 置 增强 的 方法 ， 在 
这 里 实现 了 调用 。 


e AspectJAfterAdvice. 


后 置 增强 与 前 置 增强 有 稍 许 不 一 致 的 地 方 。 回 
顾 之 前 讲 过 的 前 置 增强 ， 大 致 的 结构 是 在 拦截 右 链 
中 放置 MethodBeforeAdviceInterceptor， 而 在 








MethodBeforeAdvicelnterceptor'# X JA E. f. 
AspectJMethodBeforeAdvice， 并 在 调用 invoke 时 首 
完 串 联 调 用 。 但 是 在 后 置 增强 的 时 候 却 不 一 样 ， 没 
有 提供 中 间 的 类 ， 而 是 直接 在 拦截 器 链 中 使 用 了 中 
间 的 AspectJAfterAdvice。 











public class AspectJAfterAdvice extends AbstractAspectJAdvice i 
mplements MethodInterceptor, 
AfterAdvice ( 


public AspectJAfterAdvice( 
Method aspectJBeforeAdviceMethod, AspectJExpressio 
nPointcut pointcut, 
AspectInstanceFactory aif) { 


super(aspectJBeforeAdviceMethod, pointcut, aif); 











} 
public Object invoke(MethodInvocation mi) throws Throwable 
t 
try { 
return mi.proceed(); 
} 
finally { 
// 激 活 增 强 方法 
invokeAdviceMethod 


(getJoinPointMatch(), null, null); 


J 


public boolean isBeforeAdvice() { 
return false; 


} 


public boolean isAfterAdvice() { 
return true; 


} 


2. 增加 同步 实例 化 增强 需 





如 末 寻 找 的 增强 器 不 为 空 而 且 又 配置 了 增强 延 
述 初 始 化 ， 那 么 就 需要 在 站 位 加 入 同步 实例 化 增强 
人 髓 。 同 步 实 例 化 增强 器 SyntheticInstantiationAdvisor 
如 下 : 





protected static class SyntheticInstantiationAdvisor extends De 
faultPointcutAdvisor { 


public SyntheticInstantiationAdvisor(final MetadataAwa 
reAspectInstanceFactory aif) { 
super(aif.getAspectMetadata().getPerClausePointcut 
(), new MethodBeforeAdvice() { 
// 目 标 方法 前 调用 ， 类 似 @Before 
public void before(Method method, Object[] arg 
s, Object target) { 





// 简 单 初始 化 aspect 
aif.getAspectInstance(); 


j 





3. 获取 DeclareParents 注 解 


DeclareParents 主 要 用 于 引 介 增 强 的 注解 形式 的 
实现 ， 而 其 实现 方式 与 普通 增强 很 类 似 ， 只 不 过 使 
用 DeclareParentsAdvisor 对 功能 进行 封装 。 





private Advisor getDeclareParentsAdvisor(Field introductionFiel 
d) i 
DeclareParents declareParents - (DeclareParents) intro 
ductionField.getAnnotation (DeclareParents.class); 
if (declareParents == null) { 
// Not an introduction field 
return null; 


j 


if (DeclareParents.class.equals(declareParents.default 


Impl())) 1 


// This is what comes back if it wasn't set. This 
seems bizarre... 

// TODO this restriction possibly should be relaxe 
d 

throw new IllegalStateException("defaultlImpl must 
be set on Declare Parents"); 


j 


return new DeclareParentsAdvisor( 
introductionField.getType(), declareParents.va 
lue(), declareParents. defaultimpl()); 





7.3.2 TER DL BUT] gh ae 


前 面 的 函数 中 已 经 完成 了 所 有 增强 器 的 解析 ， 
但 是 对 于 所 有 增强 器 来 讲 ， 并 不 一 定 都 适用 于 当前 
的 Bean， 还 要 挑 取 出 适合 的 增强 磺 ， 也 融 是 满足 我 
们 配置 的 通配符 的 增强 右 。 有 基体 实现 在 
findAdvisorsThatCanApply 中 。 





protected List<Advisor> findAdvisorsThatCanApply( 
List«Advisor» candidateAdvisors, Class beanClass, 
String beanName) { 


ProxyCreationContext.setCurrentProxiedBeanName(beanNam 
e); 
try { 
// 过 滤 已 经 得 到 的 advisors 
return AopUtils.findAdvisorsThatCanApply 





(candidateAdvisors, beanClass); 


} 
finally { 
ProxyCreationContext.setCurrentProxiedBeanName(nul 





Ak 5:75 findAdvisorsThatCanApply: 





public static List<Advisor> findAdvisorsThatCanApply(List<Advis 
or» candidateAdvisors, Class<?> clazz) ( 
if (candidateAdvisors.isEmpty()) ( 
return candidateAdvisors; 


























d 
List<Advisor> eligibleAdvisors = new LinkedList<Adviso 
r>(); 
// 首 先 处 理 引 介 增 强 
for (Advisor candidate : candidateAdvisors) { 
if (candidate instanceof IntroductionAdvisor && ca 
nApply 


(candidate, clazz)) { 
eligibleAdvisors.add(candidate) ; 
} 
} 


boolean hasIntroductions = !eligibleAdvisors.isEmpty() 


for (Advisor candidate : candidateAdvisors) { 

// 引 介 增 强 已 经 处 理 

if (candidate instanceof IntroductionAdvisor) { 
continue; 









































} 
// 对 于 普通 bean 的 处 理 








if (canApply(candidate, clazz, hasIntroductions) ) 


eligibleAdvisors.add(candidate); 
} 
} 


return eligibleAdvisors; 
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强 与 普通 的 增强 处 理 是 不 一 样 的 ， 所 以 分 开 处 理 。 
而 对 于 真正 的 匹配 在 canApply 中 实现 。 








public static boolean canApply(Advisor advisor, Class<?> target 
Class, boolean 
hasIntroductions) ( 
if (advisor instanceof IntroductionAdvisor) { 
return ((IntroductionAdvisor) advisor).getClassFil 
ter().matches (targetClass); 
jelse if (advisor instanceof PointcutAdvisor) { 
PointcutAdvisor pca = (PointcutAdvisor) advisor; 
return canApply 


(pca.getPointcut(), targetClass, hasIntroductions); 
yelse ( 
// It doesn't have a pointcut so we assume it appl 
ies. 
return true; 


public static boolean canApply(Pointcut pc, Class<?> targetClas 
s, boolean hasIntroductions) { 
Assert.notNull(pc, "Pointcut must not be null"); 
if (!pc.getClassFilter().matches(targetClass)) { 
return false; 
} 


MethodMatcher methodMatcher - pc.getMethodMatcher(); 
IntroductionAwareMethodMatcher introductionAwareMethod 
Matcher - null; 
if (methodMatcher instanceof IntroductionAwareMethodMa 
tcher) { 
introductionAwareMethodMatcher - (IntroductionAwar 
eMethodMatcher) methodMatcher; 


j 


Set«Class» classes = new HashSet<Class>(ClassUtils.get 
AllInterfacesForClassAsSet (targetClass)); 
classes.add(targetClass); 
//classes:[interface test.IITestBean, class test.TestB 
ean] 
for (Class«?» clazz : classes) ( 
Method[] methods - clazz.getMethods(); 
for (Method method : methods) { 
if ((introductionAwareMethodMatcher !- null && 
introductionAwareMethodMatcher.matches 
(method, targetClass, 
hasIntroductions)) || 
methodMatcher.matches(method, targetCl 
ass)) 1 


return true; 


j 


return false; 





7.3.3 ”创建 代理 


在 获取 了 所 有 对 应 bean 的 增强 器 后 ， 便 可 以 进 
行 代理 的 创建 了 。 


protected Object createProxy( 


Class<?> beanClass, String beanName, Object[] spec 
ificInterceptors, 
TargetSource targetSource) ( 


ProxyFactory proxyFactory - new ProxyFactory(); 
// 获 取 当 前 类 中 相关 属性 
proxyFactory.copyFrom(this); 
// 决 定 对 于 给 定 的 bean 是 否 应 该 使 用 targetclass 而 不 是 它 的 接口 代理 ， 
// 检 查 proxyTargeClass 设 置 以 及 preserveTargetclass 属 性 
if (!shouldProxyTargetClass(beanClass, beanName)) { 
// Must allow for introductions; can't just set in 
terfaces to 
// the target's interfaces only. 
Class<?>[] targetInterfaces = ClassUtils.getAllint 
erfacesForClass(beanClass, this.proxyClassLoader ); 
for (Class<?> targetInterface : targetInterfaces) 



































{ 














// 添 加 代理 接口 
proxyFactory.addInterface(targetInterface); 








j 


Advisor[] advisors = buildAdvisors(beanName, SpecificI 
nterceptors); 
for (Advisor advisor : advisors) { 
// 加 入 增强 器 
proxyFactory.addAdvisor(advisor); 


























} 

// 设 置 要 代理 的 类 

proxyFactory.setTargetSource(targetSource); 

// 定 制 代理 

customizeProxyFactory(proxyFactory); 

// 用 来 控制 代理 工厂 被 配置 之 后 ， 是 否 还 允许 修改 通知 

a 《 即 在 代理 被 配置 之 后 ， 不 允许 修改 代理 的 配置 ) 

proxyFactory.setFrozen(this.freezeProxy); 

if (advisorsPreFiltered()) (1 
proxyFactory.setPreFiltered(true); 











































































































j 


return proxyFactory.getProxy 


(this.proxyClassLoader); 
j 








对 于 代理 类 的 创建 及 处 理 ，Spring 委 托 给 了 
ProxyFactory 去 处 理 ， 而 在 此 函数 中 主要 是 对 
ProxyFactory 的 初始 化 操作 ， 进 而 对 真正 的 创建 代 
理 做 准备 ， 这 些 初始 化 操作 包括 如 下 内 容 。 


1. 获取 当前 类 中 的 属性 。 

2. 添加 代理 接口 。 

3. 封装 Advisor 并 加 入 到 ProxyFactory 中 。 
4. 设置 要 代理 的 类 。 


5. 当然 在 Spring 中 还 为 子 类 提供 了 定制 的 函数 
customizeProxyFactory， 子 类 可 以 在 此 函数 中 进行 
对 ProxyFactory 的 进一步 封装 。 


6. 进行 获取 代理 操作 。 


其 中 ， 封 狼 Advisor 并 加 入 到 ProxyFactory 中 以 
及 创建 代理 是 两 个 相对 繁 开 的 过 程 ， 可 以 通过 
ProxyFactory 提 供 的 addAdvisor 方 法 直接 将 增强 器 置 
入 代理 创建 工厂 中 ,但 古 将 拦截 右 封 装 为 增强 器 还 


EI E HE 


是 需要 一 定 的 逻辑 的 。 








protected Advisor[] buildAdvisors(String beanName, Object[] spe 
cificInterceptors) ( 
// 解 析 注 册 的 所 有 interceptorName 








Advisor[] commonInterceptors = resolveInterceptorNames 


(0; 


List«Object» allInterceptors = new ArrayList«Object»() 


if (specificInterceptors != null) { 

// 加 入 拦截 器 

alliInterceptors.addAll(Arrays.asList(specificInter 
ceptors)); 

if (commonInterceptors !- null) { 

if (this.applyCommonInterceptorsFirst) { 
alliInterceptors.addAll(0, Arrays.asList(co 

mmonInterceptors)); 


} 
else ( 
alliInterceptors.addAll(Arrays.asList(commo 
ninterceptors)); 
} 


} 
} 
if (logger.isDebugEnabled()) { 
int nrOfCommonlInterceptors = (commonInterceptors ! 
- null ? commonInterceptors. 
length : 0); 
int nrOfSpecificInterceptors = (SpecificIntercepto 
rs != null ? specificInterceptors. 
length : 0); 
logger.debug("Creating implicit proxy for bean '" 
+ beanName + "' with " + nrOfCommonInterceptors + 
" common interceptors and " + nrOfSpecific 
Interceptors + " specific 
interceptors"); 


j 


Advisor[] advisors - new Advisor[allInterceptors.size( 


)l; 


for (int i = 0; i < allinterceptors.size(); i++) { 
// 拦 截 器 进行 封装 转化 为 Advisor 
advisors[i] = this.advisorAdapterRegistry.wrap 
(allInterceptors.get(i)); 


return advisors; 


public Advisor wrap(Object adviceObject) throws UnknownAdviceTy 
peException ( 
// 如 果 要 封装 的 对 象 本 身 就 是 Advisor 类 型 的 ， 那 么 无 须 再 做 过 多 处 理 
if (adviceObject instanceof Advisor) ( 
return (Advisor) adviceObject; 


























} 
// 因 为 此 封装 方法 只 对 Advisor 与 Advice 两 种 类 型 的 数据 有 效 ， 如 果 不 
是 将 不 能 封装 
if (!(adviceObject instanceof Advice)) { 
throw new UnknownAdviceTypeException(adviceObject) 





~ 


} 
Advice advice = (Advice) adviceObject; 
if (advice instanceof MethodInterceptor) { 
// 如 果 是 MethodInterceptor 类 型 则 使 用 DefaultPointcutAdv 
isor 封 装 


return new DefaultPointcutAdvisor(advice); 




















} 
// 如 果 存 在 Advisor 的 适配器 那么 也 同样 需要 进行 封装 
for (AdvisorAdapter adapter : this.adapters) { 
// Check that it is supported. 
if (adapter.supportsAdvice(advice)) { 
return new DefaultPointcutAdvisor(advice); 
} 





j 


throw new UnknownAdviceTypeException(advice); 





由 于 Spring 中 涉及 过 多 的 拦截 器 、 增 强 器 、 增 
强 方法 等 方式 来 对 人 逻辑 进行 增强 ， 所 以 非常 有 必要 
统一 封装 成 Advisor 来 进行 代理 的 创建 ， 完 成 了 增强 
的 封装 过 程 ， 那 么 解析 最 重要 的 一 步 束 是 代理 的 创 
建 与 获取 了 。 





public Object getProxy(ClassLoader classLoader) { 
return createAopProxy 


().getProxy 


(classLoader); 





1. 创建 代理 





protected final synchronized AopProxy createAopProxy() { 
if (!this.active) { 
activate(); 














} 
// 创 建 代理 
return getAopProxyFactory().createAopProxy 








(this); 
} 
public AopProxy createAopProxy(AdvisedSupport config) throws Ao 
pConfigException ( 
if (config.isOptimize() || config.isProxyTargetClass() 
|| hasNoUserSuppliedProxy Interfaces(config)) { 


Class targetClass - config.getTargetClass(); 
if (targetClass -- null) ( 
throw new AopConfigException("TargetSource can 
not determine target 
class: " + 
"Either an interface or a target is re 
quired for proxy creation."); 
} 
if (targetClass.isInterface()) { 
return new JdkDynamicAopProxy(config); 


} 
if (!cglibAvailable) { 
throw new AopConfigException( 
"Cannot proxy target class because CGL 
IB2 is not available. " + 
"Add CGLIB to the class path or specif 
y proxy interfaces."); 


return CglibProxyFactory.createCglibProxy(config); 


else ( 
return new JdkDynamicAopProxy(config); 





到 此 已 经 完成 了 代理 的 创建 ， 不 管 我 们 之 前 是 





售 阅 读 过 Spring 的 源 代 码 ， 但 是 都 或 多 或 少 地 听 过 
对 于 Spring 的 代理 中 JDKProxy 的 实现 和 CglibProxy 
的 实现 。Spring 是 如 何 选取 的 呢 ? 网 上 的 介绍 有 很 
Z, WER SAIS Aa, AA BIS 
Spring 是 如 何 选择 代理 方式 的 。 


从 这 中 的 判断 条 件 可 以 看 到 3 个 方面 影响 着 
Spring 的 判断 。 


optimize: 用 来 控制 通过 CGLIB 创 建 的 代理 是 人 否 
使 用 激进 的 优化 策略 。 除 非 完 全 了 解 AOP 代 理 
如 何 处 理 优 化 ， 人 否则 不 推荐 用 户 使 用 这 个 设 

置 。 目 前 这 个 属性 仅 用 于 CGLIB 人 代理， 对 于 JDK 
动态 代理 〈 黑 认 代理 ) 无 效 。 

proxyTargetClass: 这 个 属性 为 true 时 ， 目 标 类 本 
号 被 代理 而 不 是 目标 类 的 接口 。 如 果 这 个 属性 
值 被 设 为 true，CGLIB 代 理 将 被 创建 ， 设 置 方式 
为 <aop:aspectj-autoproxy- proxy-target- 
class="true"/>. 
hasNoUserSuppliedProxyInterfaces: 是 否 存在 代 








理 接 口 。 
下 面 是 对 JDK 与 Cglib 方 式 的 总 结 。 


e 如果 目 标 对 象 实现 了 接口 ， 默 认 情 况 下 会 采用 
JDK 的 动态 代理 实现 AOP。 

。 如 有 果 目 标 对 象 实 现 了 接口 ， 可 以 强制 使 用 
CGLIB 实 现 AOP。 

。 如 果 目 标 对 象 没 有 实现 接口 ， 必 须 采 用 CGLIB 
库 ，Spring 会 自动 在 JDK 动 态 代 理 和 CGLIB 之 间 
转换 。 


如 何 强 制 使 用 CGLIB 实 现 AOP? 














e 2SJNCGLIB/#, Spring HOME/cglib/*.jar. 
。 在 Spring 配置 文件 中 加 入 <aop:aspectj-autoproxy 
proxy-target-class="true"/>. 


JDK 动 态 代 理 和 CGLIB 字 节 码 生成 的 区 别 ? 


。JDK 动 态 代 理 只 能 对 实现 了 接口 的 类 生成 代理 ， 
而 不 能 针对 类 。 

。CGLIB 是 针对 类 实现 代理 ， 主 要 是 对 指定 的 类 
生成 一 个 子 类 ， 禾 畜 其 中 的 方法 ， 因 为 是 继 
际 ， 所 以 该 类 或 方法 最 好 不 要 声明 成 final。 





2. FRM 

确定 了 使 用 哪 种 代理 方式 后 便 可 以 进行 代理 的 
创建 了 ， 但 是 创建 之 前 有 必要 回顾 一 下 两 种 方式 的 
使 用 方法 。 

1. JDK 代 理 使 用 示例 。 


创建 业务 接口 ， 业 务 对 外 提供 的 接口 ， 包 含 看 
业务 可 以 对 外 提供 的 功能 。 





public interface UserService { 





fre 
* 目标 方法 


public abstract void add(); 





创建 业务 接口 实现 类 。 


public class UserServiceImpl implements UserService { 


/* (non-Javadoc) 
* @see dynamic.proxy.UserServicezadd() 
*/ 

public void add() { 


System.out.println(" 





创建 自 定 义 的 InvocationHandler， 用 于 对 接口 
提供 的 方法 进行 增强 。 





public class MyInvocationHandler implements InvocationHandler { 


// 目标 对 象 
private Object target; 


Uo 
* 构造 方法 
* param target 目 标 对 象 
*/ 
public MyInvocationHandler (Object target) { 
super(); 
this.target = target; 





get 
* 执行 目标 对 象 的 方法 
public Object invoke(Object proxy, Method method, Object[] 
args) throws Throwable { 








// 在 目标 对 象 的 方法 执行 之 前 简单 打印 一 下 
System.out.println("------------------ before----------- 


, 


// 执行 目标 对 象 的 方法 
Object result = method.invoke(target, args); 








// 在 目标 对 象 的 方法 执行 之 后 简单 打印 一 下 
System.out.println("------------------- aftereseeseese ss 


了 


return result; 


j 


Joe 

* 获取 目标 对 象 的 代理 对 象 
* @return 代 理 对 象 

SJ: 






































public Object getProxy() (1 
return Proxy.newProxyInstance(Thread.currentThread().ge 
tContextClassLoader(), 
target.getClass().getInterfaces(), this); 


j 








最 后 进行 测试 ， 验 证 对 于 接口 的 增强 是 耕 起 到 
作用 。 


public class ProxyTest { 


@Test 
public void testProxy() throws Throwable { 
// 实例 化 目标 对 象 


UserService userService = new UserServiceImpl(); 


// 实例 化 InvocationHandler 
MyInvocationHandler invocationHandler = new MyInvocatio 
nHandler(userService); 

















// 根据 目标 对 象 生 成 代理 对 象 
UserService proxy = (UserService) invocationHandler.get 
Proxy(); 























// WAAR Z1 32 
proxy.add(); 











HEKRA, ESRI EAS EEAO — 
简单 实现 了 ， 在 目标 对 象 的 方法 执行 之 前 和 执行 之 
后 进行 了 增强 。Spring 的 AOP 实 现 其 实 也 是 用 了 
Proxy 和 InvocationHandler 这 两 个 东西 的 。 


我 们 再 次 来 回顾 一 下 使 用 JDK 代 理 的 方式 ， 在 
整个 创建 过 程 中 ， 对 于 InvocationHandler 的 创建 是 
最 为 核心 的 ， 在 自 定 义 的 InvocationHandler 中 需要 
重 写 3 个 函数 。 


。 构 造 函 数 ， 将 代理 的 对 象 传 入 。 

。invoke 方 法 ， 此 方法 中 实现 了 AOP 增 强 的 所 有 过 
辑 。 

e getProxy 方 法 ， 此 方法 千篇一律 ， 但 是 必 不 可 


少 。 


那么 ， 我 们 看 看 Spring 中 的 JDK 代 理 实现 是 不 
是 也 是 这 么 做 的 呢 ? ABE ATA ERR, BIA 
JdkDynamicAopProxy 的 getProxy。 




















public Object getProxy(ClassLoader classLoader) { 
if (logger.isDebugEnabled()) { 


logger.debug("Creating JDK dynamic proxy: target s 
ource is " + this. 
advised.getTargetSource()); 


Class[] proxiedInterfaces - AopProxyUtils.completeProx 
iedInterfaces(this.advised); 
findDefinedEqualsAndHashCodeMethods(proxiedInterfaces) 


return Proxy.newProxyInstance(classLoader, proxiedInte 


rfaces, this); 


j 


通过 之 前 的 示例 我 们 知道 ，JDKProxy 的 使 用 关 
键 是 创建 自 定 义 的 PmvocationHandler， 而 
InvocationHandler"H ES [f m E28 ss BJ PR 
getProxy， 而 当前 的 方法 正 是 完成 了 这 个 操作 。 再 
次 确认 一 下 JdkDynamicAopProxy 也 确实 实现 了 
InvocationHandlergz O, ASA BETTY VASE DT HA, 
fEJdkDynamicAopProxy'# — 4€ A invoke ef XL, 
JFHJ dkDynamicA opProxy 2 FEAOPHY EZ C237 TRIES E 
其 中 。 查 看 代码 ， 果 然 有 这 样 一 个 函数 : 








public Object invoke(Object proxy, Method method, Object[] args 
) throws Throwable { 

MethodInvocation invocation; 

Object oldProxy - null; 

boolean setProxyContext - false; 


TargetSource targetSource - this.advised.targetSource; 
Class targetClass - null; 
Object target - null; 


try { 
//equals 方 法 的 处 理 
if (!this.equalsDefined && AopUtils.isEqualsMethod 
(method)) { 























return equals(args[0]); 

















} 

//hash 方 法 的 处 理 

if (!this.hashCodeDefined && AopUtils.isHashCodeMe 
thod(method)) { 








return hashCode(); 
} 
/* 
* Class#MWisAssignableFrom(Class cls) Vik: 








* ”如果 调 用 这 个 方法 的 class 或 接口 与 参数 cl1s 表 示 的 类 或 接口 相 
同 ， 

* 或 者 是 参数 cls 表 示 的 类 或 接口 的 父 类 ， 则 返回 true。 

* 形象 地 : 自身 类 .class.isAssignableFrom( 自 身 类 或 子 类 .Cc 
lass) ”返回 true 





例 : 
? System.out.println(ArrayList.class.isAssigna 
bleFrom(Object.class)); 
//false 
< System.out.println(Object.class.isAssignabl 
eFrom(ArrayList.class)); 
//true 
*/ 
if (!this.advised.opaque && method.getDeclaringCla 
ss().isInterface() && 
method.getDeclaringClass().isAssignableFro 
m(Advised.class)) ( 
return AopUtils.invokeJoinpointUsingReflection 
(this.advised, method, args); 


j 


Object retVal; 
// 有 时 候 目标 对 象 内 部 的 自我 调用 将 无 法 实施 切面 中 的 增强 则 需要 通 
过 此 属性 暴露 代理 
if (this.advised.exposeProxy) { 
oldProxy - AopContext.setCurrentProxy(proxy); 
setProxyContext - true; 









































j 


target - targetSource.getTarget(); 
if (target !- null) ( 

targetClass - target.getClass(); 
} 


// 获 取 当 前 方法 的 拦截 器 链 
List«Object» chain = this.advised.getInterceptorsA 
ndDynamicInterceptionAdvice (method, targetClass); 





if (chain.isEmpty()) (1 
// 如 果 没 有 发 现任 何 拦截 器 那么 直接 调用 切 点 方法 
retVal = AopUtils.invokeJoinpointUsingReflecti 
on(target, method, args); 
jelse ( 
// 将 拦截 器 封装 在 ReflectiveMethodInvocation， 
// 以 便于 使 用 其 proceed 进 行 链 接 表 用 拦截 器 











invocation - new ReflectiveMethodInvocation(pr 
oxy, target, method, 
args, targetClass, chain); 


// 执 行 拦截 器 链 
retVal = invocation.proceed(); 


Jj 


// 返 回 结果 
if (retVal !- null && retVal == target && method.g 
etReturnType(). IsInstance (proxy) && 


!RawTargetAccess.class.isAssignableFrom(me 
thod.getDeclaringClass())) { 
retVal - proxy; 





j 


return retVal; 


} 
finally { 
if (target !- null && !targetSource.isStatic()) { 
// Must have come from TargetSource. 
targetSource.releaseTarget(target); 


} 

if (setProxyContext) { 
// Restore old proxy. 
AopContext.setCurrentProxy(oldProxy); 





上 面 的 函数 中 最 主要 的 工作 束 古 创建 了 一 个 拦 
age te, JPfSH]ReflectiveMethodInvocation2S 3t 47 
了 链 的 封装 ， 而 在 ReflectiveMethodInvocation 类 的 
proceed 方 法 中 实现 了 拦截 句 的 逐一 调用 ， 那 么 我 们 








继续 来 探究 ， 在 proceed 方 法 中 是 怎么 实现 前 置 增强 
在 目标 方法 前 调用 后 置 增强 在 目标 方法 后 调用 的 好 








辑 呢 ? 





public Object proceed() throws Throwable { 
// 执行 完 所 有 增强 后 执行 切 点 方法 
if (this.currentInterceptorIndex == this.interceptorsA 
ndDynamicMethodMatchers. 
size() - 1) { 











return invokeJoinpoint(); 


j 


// 获 取 下 一 个 要 执行 的 拦截 器 
Object interceptorOrInterceptionAdvice = 





this.interceptorsAndDynamicMethodMatchers.get(++th 
is.currentInterceptorIndex); 


if (interceptorOrInterceptionAdvice instanceof Interce 
ptorAndDynamicMethodMatcher) { 
// 动 态 匹 配 
InterceptorAndDynamicMethodMatcher dm = 
(InterceptorAndDynamicMethodMatcher) intercept 
orOrInterceptionAdvice; 
if (dm.methodMatcher.matches(this.method, this.tar 
getClass, this.arguments)) { 
return dm.interceptor.invoke(this); 
jelse { 
// 不 匹配 则 不 执行 拦截 器 


return proceed(); 


























} 
}else { 
/* 普 通 拦截 器 ， 直 接 调用 拦截 器 , 比如: 
* ExposelnvocationInterceptor, 
* DelegatePerTargetObjectIntroductionInterceptor, 
* MethodBeforeAdviceInterceptor 
* Aspect JAroundAdvice, 
* Aspect JAfterAdvice 
ty 
// 将 this 作 为 参数 传递 以 保证 当前 实例 中 调用 链 的 执行 
return ((MethodInterceptor) interceptorOrIntercept 
ionAdvice).invoke(this); 








) 

MENU 

fEproceed IEF, BOVE AUER IAI HL 128 
RIA BAR, ReflectiveMethodInvocation'# HJ E 
要 职责 是 维护 了 链接 调用 的 计数 器 ， 记 录 着 当前 调 
用 链接 的 位 置 ， 以 便 链 可 以 有 序 地 进行 下 去 ， 那 么 
在 这 个 方法 中 并 没有 我 们 之 前 设想 的 维护 各 种 增强 
的 顺序 ， 而 是 将 此 工作 委托 给 了 各 个 增强 器 ， 使 各 
个 增强 右 在 内 部 进行 逻辑 实现 。 


2. CGLIB 使 用 示例 。 


CGLIB 是 一 个 强大 的 蜗 性 能 的 代码 生成 包 。 它 
广泛 地 被 许多 AOP 的 框架 使 用 ， 例 如 Spring AOP 和 
dynaop， 为 它们 提供 方法 的 Interception 〈 拦 截 ) 。 
最 流行 的 OR Mapping 工 具 Hibernate 也 使 用 CGLIB 来 
代理 单 端 single-ended〈 多 对 一 和 一 对 一 ) 关联 (对 
集合 的 延迟 抓 取 是 采用 其 他 机 制 实现 的 ) 。 
EasyMock 和 jMock 是 通过 使 用 模仿 (moke) 对 象 来 
测试 Java 代 码 的 包 。 它 们 都 通过 使 用 CGLIB 来 为 那 
些 没有 接口 的 类 创建 模仿 (moke) 对 象 。 


CGLIB 包 的 的 层 通过 使 用 一 个 小 而 快 的 字 市 码 
处 理 框 染 ASM， 来 转换 字 市 码 并 生成 新 的 类 。 际 了 
CGLIB 包 ， 脚 本 语言 例如 Groovy 和 BeanShell， 也 是 

















使 用 ASM 来 生成 Java 的 字 节 人 码 。 当 然 不 或 励 直接 使 
用 ASM， 因 为 它 要 求 你 必须 对 JVM 内 部 结构 (包括 
class 文 件 的 格式 和 指令 集 ) 都 很 熟悉 。 


我 们 先 快速 地 了 解 CGLIB 的 使 用 示例 。 








import java. 
import net.sf.cglib.proxy.Enhancer; 
import net.sf.cglib.proxy.MethodInterceptor; 
import net.sf.cglib.proxy.MethodProxy; 


lang.reflect.Method; 


public class EnhancerDemo { 
public static void main(String[] args) { 
Enhancer enhancer - new Enhancer(); 
enhancer.setSuperclass(EnhancerDemo.class); 
enhancer.setCallback(new MethodInterceptoriImpl()); 


EnhancerDemo demo - (EnhancerDemo) enhancer.create(); 
demo.test(); 


System.out. 


j 


println(demo); 


public void test() { 


System.out. 


j 


private static 
dInterceptor { 


println("EnhancerDemo test()"); 


class MethodInterceptoriImpl implements Metho 


public Object intercept(Object obj, Method method, Obje 


MethodProxy proxy) throws Throwable { 


QOverride 
ct[] args, 
System. 
Object 
System. 
return 
} 
} 


err.println("Before invoke " + method); 
result - proxy.invokeSuper(obj, args); 
err.println("After invoke" + method); 
result; 





运行 结果 如 下 : 


Before invoke public void EnhancerDemo.test() 

EnhancerDemo test() 

After invokepublic void EnhancerDemo.test() 

Before invoke public java.lang.String java.lang.Object.toString 


0 


Before invoke public native int java.lang.Object.hashCode() 


After invokepublic native int java.lang.Object.hashCode() 
After invokepublic java.lang.String java.lang.Object.toString() 


EnhancerDemo$$EnhancerByCGLIB$$bc9b2066@1621e42 





可 以 看 到 System.out.printIn(demo), demo £i ^c Wil 
用 了 toString0 方 法 ， 然 后 义 调 用 了 hashCode， 生 成 
的 对 象 为 
EnhancerDemo$$EnhancerByCGLIB$$bc9b2066 的 实 
例 ， 这 个 类 是 运行 时 由 CGLIB 产 生 的 。 





完成 CGLIB 代 理 的 类 是 委托 给 Cglib2AopProxy 
RE SLIM, BATE ATE PSR RIE SE 


按照 前 面 提供 的 示例 ， 我 们 容易 判断 出 来 ， 
Cglib2AopProxy 的 入 口 应 该 是 在 getProxy， 也 就 是 
说 在 Cglib2AopProxy 类 的 getProxy 方 法 中 实现 了 
Enhancer 的 创建 及 接口 封装 。 





public Object getProxy(ClassLoader classLoader) { 
if (logger.isDebugEnabled()) { 
logger.debug("Creating CGLIB2 proxy: target source 


is " + this.advised. 
getTargetSource()); 
} 


try { 
Class rootClass = this.advised.getTargetClass(); 
Assert.state(rootClass !- null, "Target class must 


be available for 
creating a CGLIB proxy"); 


Class proxySuperClass - rootClass; 
if (ClassUtils.isCglibProxyClass(rootClass)) { 
proxySuperClass - rootClass.getSuperclass(); 
Class[] additionallInterfaces = rootClass.getIn 
terfaces(); 
for (Class additionallinterface : additionalInt 
erfaces) ( 
this.advised.addInterface(additionallInterf 




















ace); 
} 
} 
// 验 证 Class 
validateClassIfNecessary(proxySuperClass); 
// 创 建 及 配置 Enhancer 
Enhancer enhancer = createEnhancer(); 
if (classLoader !- null) ( 
enhancer.setClassLoader(classLoader); 
if (classLoader instanceof SmartClassLoader && 
((SmartClassLoader) classLoader).isCla 
ssReloadable(proxy 


SuperClass)) ( 
enhancer.setUseCache(false); 
} 
} 


enhancer.setSuperclass(proxySuperClass); 

enhancer.setStrategy(new UndeclaredThrowableStrate 
gy(UndeclaredThrowable Exception.class)); 

enhancer .setInterfaces(AopProxyUtils.completeProxi 
edInterfaces(this.advised)); 

enhancer.setiInterceptDuringConstruction(false); 


// 设 置 拦截 器 
Callback[] callbacks = getCallbacks 


(rootClass); 
enhancer.setCallbacks(callbacks); 
enhancer.setCallbackFilter(new ProxyCallbackFilter 
( 
this.advised.getConfigurationOnlyCopy(), t 
his.fixedInterceptorMap, 
this.fixedInterceptorOffset)); 


Class[] types = new Class[callbacks.length]; 
for (int x = 0; x < types.length; x++) ( 
types[x] = callbacks[x].getClass(); 


enhancer.setCallbackTypes(types); 



































// 生 成 代理 类 以 及 创建 代理 
Object proxy; 
if (this.constructorArgs !- null) ( 
proxy - enhancer.create(this.constructorArgTyp 
es, this.constructorArgs); 








} 
else ( 

proxy = enhancer.create( ); 
j 


return proxy; 


catch (CodeGenerationException ex) ( 
throw new AopConfigException("Could not generate C 

GLIB subclass of class [" + 

this.advised.getTargetClass() + "]: " + 

"Common causes of this problem include usi 
ng a final class or a 
non-visible class", 

ex); 


catch (IllegalArgumentException ex) { 
throw new AopConfigException("Could not generate C 

GLIB subclass of class [" + 

this.advised.getTargetClass() + "]: "+ 

"Common causes of this problem include usi 
ng a final class or a 
non-visible class", 

ex); 


j 


catch (Exception ex) { 
// TargetSource.getTarget() failed 


throw new AopConfigException("Unexpected AOP excep 
tion", ex); 


j 





以 上 函数 完整 地 阐述 了 一 个 创建 Spring 中 的 
Enhancer 的 过 程 ， 旋 者 可 以 参考 Enhancer 的 文档 否 
看 每 个 步骤 的 含义 ， 这 里 最 重要 的 是 通过 





getCallbacks 方 法 设置 拦截 器 链 。 





private Callback[] getCallbacks(Class rootClass) throws Excepti 


on { 




















// 对 于 expose-proxy 属 性 的 处 理 
boolean exposeProxy = this.advised.isExposeProxy(); 
boolean isFrozen - this.advised.isFrozen(); 

boolean isStatic - this.advised.getTargetSource().isSt 





atic(); 


// 将 拦截 器 封装 在 DynamicAdvisedInterceptor 中 
Callback aopInterceptor = new DynamicAdvisedIntercepto 
r(this.advised); 


// Choose a "straight to target" interceptor. (used fo 
r calls that are 
// unadvised but can return this). May be required to 
expose the proxy. 
Callback targetInterceptor; 
if (exposeProxy) ( 
targetInterceptor - isStatic ? 
new StaticUnadvisedExposedInterceptor (thi 
s.advised.getTargetSource(). 
getTarget()) 
new DynamicUnadvisedExposedInterceptor(thi 
s.advised.getTargetSource( )); 


yelse ( 
targetInterceptor - isStatic ? 
new StaticUnadvisedInterceptor(this.advise 
d.getTargetSource(). getTarget()) 
new DynamicUnadvisedInterceptor(this.advis 
ed.getTargetSource( )); 


// Choose a "direct to target" dispatcher (used for 
// unadvised calls to static targets that cannot retur 
n this). 
Callback targetDispatcher - isStatic ? 
new StaticDispatcher(this.advised.getTargetSou 
rce().getTarget()) : new 
SerializableNoOp(); 


Callback[] mainCallbacks = new Callback[]{ 
// 将 拦截 器 链 加 入 Callback 中 
aopInterceptor, 


targetInterceptor, // invoke target without consid 
ering advice, if optimized 

new SerializableNoOp(), // no override for methods 
mapped to this 

targetDispatcher, this.advisedDispatcher, 


new EqualsInterceptor(this.advised), 
new HashCodeInterceptor(this.advised) 


Callback[] callbacks; 


// If the target is a static one and the advice chain 
is frozen, 

// then we can make some optimisations by sending the 
AOP calls 

// direct to the target using the fixed chain for that 


method. 
if (isStatic && isFrozen) { 
Method[] methods - rootClass.getMethods(); 
Callback[] fixedCallbacks = new Callback[methods.l 
ength]; 


this.fixedInterceptorMap = new HashMap<String, Int 
eger>(methods.length); 


// TODO: small memory optimisation here (can skip 
creation for 
// methods with no advice) 
for (int x = 0; x < methods.length; x++) { 
List<Object> chain = this.advised.getIntercept 
orsAndDynamic Interception Advice(methods[x], rootClass); 
fixedCallbacks[x] = new FixedChainStaticTarget 
Interceptor ( 
chain, this.advised.getTargetSource(). 
getTarget(), this.advised. getTargetClass()); 
this.fixedInterceptorMap.put(methods[x].toStri 
ng(), X); 
} 


// Now copy both the callbacks from mainCallbacks 

// and fixedCallbacks into the callbacks array. 

callbacks = new Callback[mainCallbacks.length + fi 
xedCallbacks.length]; 

System.arraycopy(mainCallbacks, ©, callbacks, ©, m 
ainCallbacks.length); 

System.arraycopy(fixedCallbacks, ©, callbacks, mai 
nCallbacks.length, 
fixedCallbacks.length); 

this.fixedInterceptorOffset - mainCallbacks.length 


j 
else ( 

callbacks - mainCallbacks; 
} 


return callbacks; 





在 getCallback 中 Spring 考虑 了 很 多 情况 ， 但 是 
对 于 我 们 来 说 ， 只 需要 理解 最 第 用 的 驶 可 以 了 ， 比 
如 将 advised 属 性 封装 在 DynamicAdvisedInterceptor 
并 加 入 在 callbacks 中 ， 这 么 做 的 目的 是 什么 呢 ， 如 
何 调用 呢 ? 在 前 面 的 示例 中 ， 我 们 了 解 到 CGLIB 中 


对 于 方法 的 拦截 是 通过 将 目 定 义 的 拦截 器 (实现 
MethodInterceptor 接 口 ) 加 入 Callback 中 并 在 调用 代 
理 时 直接 激活 拦截 器 中 的 intercept 方 法 来 实现 的 ， 
那么 在 getCallback 中 正 是 实现 了 这 样 一 个 目的 ， 
Dynamic- AdvisedInterceptor 继 承 自 
MethodInterceptor， 加 入 Callback 中 后 ， 在 再 次 调用 
代理 时 会 直接 调用 DynamicAdvisedInterceptor 中 的 
intercept 方 法 ， 由 此 推 站 ， 对 于 CGLIB 方 式 实 现 的 
代理 ， 其 核心 人 逻辑 必然 在 
DynamicAdvisedInterceptor 中 的 intercept 中 。 











public Object intercept(Object proxy, Method method, Object[] a 
rgs, MethodProxy methodProxy) throws Throwable ( 
Object oldProxy - null; 
boolean setProxyContext - false; 
Class targetClass - null; 
Object target - null; 
try { 
if (this.advised.exposeProxy) { 
// Make invocation available if necessary. 
oldProxy - AopContext.setCurrentProxy(prox 


setProxyContext - true; 
} 
target = getTarget(); 
if (target !- null) ( 
targetClass - target.getClass(); 


} 
// 获 取 拦 截 器 链 
List<Object> chain = this.advised.getIntercept 
orsAndDynamicInterceptionAdvice (method, targetClass); 
Object retVal; 
if (chain.isEmpty() && Modifier.isPublic(metho 
d.getModifiers())) { 
// 如 果 拦 截 器 链 为 空 则 直接 激活 原 方法 
retVal = methodProxy.invoke(target, args); 
yelse ( 








// 进 入 链 
retVal = new CglibMethodInvocation 


(proxy, target, method, args, 
targetClass, chain, methodProxy).proceed 


0; 
} 


retVal = massageReturnTypelfNecessary(proxy, t 
arget, method, retVal); 
return retVal; 


} 
finally { 
if (target != null) { 
releaseTarget(target); 


} 

if (setProxyContext) { 
// Restore old proxy. 
AopContext.setCurrentProxy(oldProxy); 


j 





上 述 的 实现 与 JDK 方 式 实现 代理 中 的 invoke 方 
法 大 同 小 异 ， 都 是 首先 构造 链 ， 然 后 封装 此 链 进行 
串联 调用 ， 稍 有 些 区 别 就 是 在 JDK 中 直接 构造 
ReflectiveMethodInvocation， 而 在 cglib 中 使 用 
CglibMethodInvocation。CglibMethodInvocation 继 承 
目 ReflectiveMethodInvocation， 但 是 proceed 方 法 并 
KA BUS. 


74 静态 AOP 使 用 示例 


JU ZH A CLoad-Time Weaving, LTW) 18 
A Ae TE t D LUN AS CEI AS ZA A AspectJ] 
面 。Spring 框 架 的 值 添加 为 AspectJ LTW 在 动态 织 入 
过 程 中 提供 了 更 细 粒 度 的 控制 。 使 用 Java (5+) 的 
代理 能 使 用 一 个 叫 “Vanilla” 的 AspecU LTW， 这 需 
要 在 启动 JVM 的 时 候 将 某 个 JVM 参 数 设 置 为 开 。 这 
种 JVM 汽 围 的 设置 在 一 些 情况 下 或 许 不 错 ， 但 通 滞 
情况 下 显得 有 些 粗 颗粒 。 而 用 Spring 的 LTW 能 让 你 
在 per-ClassLoader 的 基础 上 打开 LTW， 这 显然 更 加 
细 粒 度 并 且 对 “ 单 JVM 多 应 用 ”的 环境 更 具 意 义 〈 例 
如 在 一 个 典型 应 用 服务 器 环境 中 ) 。 男 外 ， 在 某 些 
环境 下 ， 这 能 让 你 使 用 LTW 而 不 对 应 用 服务 器 的 局 
动 脚 本 做 任何 改动 ， 不 然则 需要 添加 - 
javaagent:path/to/aspectjweaver.jar 或 者 (以 下 将 会 提 
K) -javaagent:path/to/Spring-agent.jar. JF x A RR 
需 简 单 修 改 应 用 上 下 文 的 一 个 或 几 个 文件 残 能 使 用 
LTW， 而 不 需 依 靠 那些 管理 者 部 普 配 置 ， 比 如 局 动 
脚本 的 系统 管理 员 。 


我 们 还 是 以 之 前 的 AOP 示 例 为 基础 ， 如 果 想 从 
动态 代理 的 方式 改 成 静态 代理 的 方式 需要 做 如 下 改 
动 。 


1. Spring 全 局 配置 文件 的 修改 ， 加 入 LWT 开 
关 。 











<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmilns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:aop="http://www.Springframework.org/schema/aop" 
xmlns:context="http://www.Springframework.org/schema/c 


ontext" 
xsi:schemaLocation-"http://www.Springframework.org/sch 
ema/beans 
http://www.Springframework.org/sch 
ema/beans/Spring- beans-3.0.xsd 


http://www.Springframework.org/sch 
ema/aop 

http://www.Springframework.org/sch 
ema/aop/Spring-aop -3.0.xsd 

http://www.Springframework.org/sch 
ema/context http: //www. 
Springframework.org/schema/context/Spring-context-3.0.xsd 

Ws 

«aop:aspectj-autoproxy /> 


«bean id-"test" class="test.TestBean"/> 


«bean class="test.AspectJTest"/> 
«context:load-time-weaver /» 


«/beans» 





2. 加 入 aop.xml。 在 class 目 录 下 的 META- 
INF( 没 有 则 自己 建立 ) 文件 夹 下 建立 aop.xml， 内 
容 如 下 : 





<!DOCTYPE aspectj PUBLIC '"-//AspectJ//DTD//EN" "http://www.ecl 
ipse.org/aspectj/dtd/ 
aspectj.dtd"> 
<aspectj> 
<weaver> 


<!-- only weave classes in our application-specific pa 
ckages --> 


«include within="test.*" /> 
</weaver> 


<aspects> 
<!-- weave in just this aspect --> 
<aspect name="test.AspectJTest" /> 
</aspects> 
</aspectj> 





主要 是 告诉 AspectJ 需 要 对 哪个 包 进 行 织 入 ， 并 
使 用 哪些 增强 器 。 


3. 加 入 局 动 参 数 。 如 果 是 在 Eclipse 中 局 动 的 
话 需 要 加 上 启动 参数 ， 如 图 7-3 所 示 。 


© Main [t= Arguments > BA JRE | “> Classpath | By Source | BB Environment| 国 Common | Tracepoint 


Program arguments: 


Variables... 


VM arguments: 
-javaagent:eAorg.springframework.instrument.jar 


Variables... 
Working directory: 


© Default: $tworkspace loc:org.springframework.context] 


Other: 


图 7-3 ”Eclipse 使 用 Aspect 的 配置 


4. 测试 。 


public static void main(String[] args) { 

ApplicationContext bf - new ClassPathXmlApplicationCon 
text("aspectTest.xml"); 

IITestBean bean-(IITestBean) bf.getBean("test"); 


bean.testBeanM(); 


j 








测试 结果 与 动态 AOP 并 无 送别 ， 打 印 出 结果 : 


beforeTest 
test 
afterTest 


75 ”创建 AOP 静 态 代 理 


AOP 的 静态 代理 主要 是 在 虚拟 机 启动 时 通过 改 
变 目 标 对 象 字 节 码 的 方式 来 完成 对 目标 对 象 的 增 
强 ， 它 与 动态 代理 相 比 具有 更 高 的 效率 ， 因 为 在 动 
态 代理 调用 的 过 程 中 ， 还 需要 一 个 动态 创建 代理 类 
并 代理 目标 对 象 的 步骤 ， 而 静态 代理 则 是 在 启动 时 
便 完成 了 字 节 码 增强 ， 当 系统 再 次 调用 目标 类 时 与 
调用 正常 的 类 并 无 差别 ， 所 以 在 效率 上 会 相对 高 
B 

















7.5.1 Instrumentationí H 


Java 在 1.5 引 入 java.lang.instrument， 你 可 以 由 此 
实现 一 个 Java agent， 通 过 此 agent 来 修改 类 的 字 节 
码 即 改变 一 个 类 。 本 节 会 通过 Java Instrument 实 现 
一 个 简单 的 profiler。 当 然 instrument 并 不 限于 
profiler, instrumentu] 以 做 很 多 事情 ， 它 类 似 一 种 更 
低级 、 更 松 粳 合 的 AOP， 可 以 从 底层 来 改变 一 个 类 
的 行为 。 你 可 以 由 此 产生 无 限 的 遐想 。 接 下 来 要 做 
的 事情 ， 吏 是 计算 一 个 方法 所 花 的 时 间 ， 通 香 我 们 
会 在 代码 中 按 以 下 方式 编写 。 


在 方法 开头 加 入 long stime = 
System.nanoTime(); ， 在 方法 结尾 通过 
System.nanoTime()-stime 得 出 方法 所 花 时 间 。 你 不 
得 不 在 想 监 控 的 每 个 方法 中 写 入 重复 的 代码 ， 好 一 
点 的 情况 ， 你 可 以 用 AOP 来 做 这 事 ， 但 总 是 感觉 
点 别扭 ， 这 种 profiler 的 代码 还 是 要 打包 在 你 的 项 目 
HH, Java Instrument 使 得 这 一 切 更 干净 。 

















1. 5ClassFileTransformerZ$ 





package org.toy; 

import java.lang.instrument.ClassFileTransformer; 

import java.lang.instrument.IllegalClassFormatException; 
import java.security.ProtectionDomain; 

import javassist.CannotCompileException; 

import javassist.ClassPool; 

import javassist.CtBehavior; 

import javassist.CtClass; 

import javassist.NotFoundException; 

import javassist.expr.ExprEditor; 


import javassist.expr.MethodCall; 
public class PerfMonXformer implements ClassFileTransformer { 
public byte[] transform(ClassLoader loader, String classNam 
e, 
Class<?> classBeingRedefined, ProtectionDomain prot 
ectionDomain, 
byte[] classfileBuffer) throws IllegalClassFormatEx 
ception ( 
byte[] transformed - null; 
System.out.println("Transforming " + className); 
ClassPool pool = ClassPool.getDefault(); 
CtClass cl - null; 
try { 
cl - pool.makeClass(new java.io.ByteArrayInputStrea 
m( 
classfileBuffer)); 
if (cl.isInterface() -- false) ( 
CtBehavior[] methods = cl.getDeclaredBehaviors( 
); 
for (int i = 0; i < methods.length; i++) { 
if (methods[i].isEmpty() == false) { 
// 修 改 method 字 节 码 
doMethod(methods[i]); 
} 
} 
transformed = cl.toBytecode(); 
} 
} catch (Exception e) { 
System.err.println("Could not instrument " + class 
Name 
+", exception : " + e.getMessage()); 
} finally { 
if (cl != null) { 
cl.detach(); 
} 
} 


return transformed; 


} 


private void doMethod(CtBehavior method) throws NotFoundExc 
eption, 
CannotCompileException { 
method.insertBefore("long stime = System.nanoTime();"); 


method.insertAfter("System.out.println(/"leave "+metho 


d.getName()+" and time:/"+(System.nanoTime()-stime));"); 


j 





2. 445 agent% 


package org.toy; 
import java.lang.instrument.Instrumentation; 
import java.lang.instrument.ClassFileTransformer ; 
public class PerfMonAgent { 
static private Instrumentation inst = null; 
/** 
* This method is called before the application's main-meth 
od is called, 
* when this agent is specified to the Java VM. 
**/ 
public static void premain(String agentArgs, Instrumentatio 
n inst) { 
System.out.println("PerfMonAgent.premain() was called." 


); 


// Initialize the static variables we use to track info 
rmation. 

inst - inst; 

// Set up the class-file transformer. 

ClassFileTransformer trans - new PerfMonXformer(); 

System.out.println("Adding a PerfMonXformer instance to 
the JVM."); 

inst.addTransformer(trans); 


j 





上 面 两 个 类 就 是 agent 的 核心 了 ，JVM 启 动 时 在 
应 用 加 载 前 会 调用 PerfMonAgent.premain， 然 后 
PerfMonAgent.premain 中 实例 化 了 一 个 定制 的 
ClassFileTransforme， 即 PerfMonXformer 并 通过 


inst.add Transformer(trans) fU PerfMonX former] Sz {| 
加 入 Instrumentation 实 例 〈 由 JVM 传 入 ) , iL 
得 应 用 中 的 类 加 载 时 ，PerfMonXformer.transform 都 
会 被 调用 ， 你 在 此 方法 中 可 以 改变 加 载 的 类 。 真 的 
有 点 神奇 ， 为 了 改变 类 的 字 节 人 码 ， 我 使 用 了 JBoss 
的 Javassist， 虽 然 你 不 一 定 要 这 么 用 ， 但 JBoss 的 
Javassist 真 的 很 强大 ， 能 让 你 很 容易 地 改变 类 的 字 
节 人 码 。 在 上 面 的 方法 中 我 通过 改变 类 的 字 节 人 码 ， 在 
每 个 类 有 的 方法 入 口中 加 入 JS long stime = 
System.nanoTime()， 在 方法 的 出 口 加 入 了 : 














System.out.println("methodClassName.methodName:"+(System.nanoTi 
me()-stime)); 





3. 打包 agent 





Fagen a, Amv. 


e JART]META-INF/MANIFEST.MFJIILA Premain- 
Class: XX，XX 在 此 语 境 中 就 是 我 们 的 agent 关 ， 

Bl org.toy.PerfMonAgent. 

。 如果 你 的 agent 类 引入 别 的 包 ， 需 使 用 Boot- 
Class-Path: xx, xxfEJGia Se wie Ete Sum 
JBoss javassit, 

EH /home/pwlazy/.m2/repository/javassist/javassist/3 
.GA/ javassist- 3.8.0.GA.jar. 











下 面 附 上 Maven 的 POML。 





[xhtml]view plaincopyprint? 
«project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi-"h 
ttp://www.w3.0rg/2001/ XMLSchema-instance" 
xSi:schemaLocation="http://maven.apache.org/POM/4.0.0 http:// 
maven.apache.org/maven- v4_0_0.xsd"> 
<modelVersion>4.0.0</modelVersion> 
«groupId»org.toy«c/groupId» 
<artifactId>toy-inst</artifactId> 
<packaging>jar</packaging> 
<version>1.0-SNAPSHOT</version> 
<name>toy-inst</name> 
<url>http://maven.apache.org</url> 
<dependencies> 
<dependency> 
<groupId>javassist</groupId> 
<artifactId>javassist</artifactId> 
<version>3.8.0.GA</version> 
</dependency> 
<dependency> 
«groupId»junit«/groupId» 
<artifactId>junit</artifactId> 
<version>3.8.1</version> 
<scope>test</scope> 
</dependency> 
</dependencies> 


<build> 
<plugins> 
<plugin> 
<groupId>org.apache.maven.plugins</groupId> 
<artifactId>maven-jar-plugin</artifactId> 
<version>2.2</version> 
<configuration> 
<archive> 
<manifestEntries> 
<Premain-Class>org.toy.PerfMonAgent</Premain-Clas 
s> 


<Boot-Class-Path>/home/pwlazy/.m2/repository/java 
ssist/javassist/3.8.0.GA/ 


javassist-3.8.0.GA.jar«/Boot-Class-Path» 


«/manifestEntries» 
«/archive» 
«/configuration» 
</plugin> 


<plugin> 
<artifactId>maven-compiler-plugin «/artifactlId > 
<configuration> 
<source> 1.6 </source > 
<target> 1.6 </target> 
</configuration> 
</plugin> 
</plugins> 


</build> 


</project> 





4. 打包 应 用 


package org.toy; 
public class App { 
public static void main(String[] args) { 
new App().test(); 


public void test() { 


System.out.println("Hello World!!"); 
} 








Java 选 项 中 有 -javaagent:xx， 其 中 xx 就 是 你 的 
agent JAR，Java 通 过 此 选项 加 载 agent， 由 agent 来 
监控 classpath 下 的 应 用 。 


最 后 的 执行 结 


PerfMonAgent.premain() was called. 

Adding a PerfMonXformer instance to the JVM. 
Transforming org/toy/App 

Hello World!! 
java.io.PrintStream.println:314216 
org.toy.App.test:540082 


Transforming java/lang/Shutdown 
Transforming java/lang/Shutdown$Lock 
java.lang.Shutdown.runHooks:29124 
java.lang.Shutdown.sequence:132768 





由 执行 结果 可 以 看 出 ， 执 行 顺 序 以 及 通过 改变 
org.toy.App 的 字 节 人 码 加 入 监控 代码 确实 生效 了 。 你 
也 可 以 发 现 ， 通 过 Instrment 实 现 agent 使 得 监控 代码 
和 应 用 代码 完全 隔离 了 。 


通过 之 前 的 两 个 小 示例 我 们 似乎 已 经 有 所 体 
会 ， 在 Spring 中 的 静态 AOP 直 接 使 用 了 Aspect 提 供 
的 方法 ， 而 AspectU 又 是 在 Instrument 基 础 上 进行 的 
封装 。 惑 以 上 面 的 例子 来 看 ， 至 少 在 AspectJ 中 会 有 
如 下 功能 。 


。 读 取 META-INF/aop.xml。 
。 将 aop.xml 中 定义 的 增强 右 通 过 目 定 义 的 
ClassFileTransformer 织 入 对 应 的 类 中 。 


当然 这 都 是 AspectJ 所 做 的 事情 ， 并 不 在 我 们 讨 
论 的 范畴 ，Spring 是 直接 使 用 AspectJ， 也 就 是 将 动 








态 代理 的 任务 直接 委托 给 了 AspectJ， 那 么 ，Spring 
怎么 能 入 AspecU 的 呢 ?同样 我 们 还 是 从 配置 文件 入 
Te 


7.5.22 Ae Mine 





在 Spring 中 如 果 需 要 使 用 AspectJ 的 功能 ， 首 先 
要 做 的 第 一 步 就 是 在 配置 文件 中 加 入 配置 : 
<context:load-time-weaver/>。 我 们 根据 之 前 介绍 的 
目 定 义 命名 空间 的 知识 便 可 以 推 新 ， 引 用 AspectJ 的 
入 口 便 是 这 里 ， 可 以 通过 查找 load-time-weaver 来 找 
到 对 应 的 自 定 义 命名 处 理 类 。 


人 通过 Eclipse 提 供 的 字符 串 搜索 功能 ， 我 们 找到 
了 ContextrNamespaceHandler， 在 其 中 有 这 样 一 段 函 
数 。 


public void init() { 
registerBeanDefinitionParser("property-placeholder", n 
ew PropertyPlaceholder BeanDefinitionParser()); 
registerBeanDefinitionParser("property-override", new 
PropertyOverrideBean DefinitionParser()); 
registerBeanDefinitionParser("annotation-config", new 
AnnotationConfigBean DefinitionParser()); 
registerBeanDefinitionParser("component-scan", new Com 
ponentScanBeanDefinition 
Parser()); 
registerBeanDefinitionParser("load-time-weaver", new L 
oadTimeweaverBeanDefinition 
Parser()); 

















registerBeanDefinitionParser("Spring-configured", new 
SpringConfiguredBeanDefinition Parser()); 

registerBeanDefinitionParser("mbean-export", new MBean 
ExportBeanDefinitionParser()); 

registerBeanDefinitionParser("mbean-server", new MBean 
ServerBeanDefinitionParser()); 


j 





继续 跟 进 
LoadTimeWeaverBeanDefinitionParser， 作 为 
BeanDefinitionParser 接 口 的 实现 类 ， 它 的 核心 逻辑 
是 从 parse 函 数 开 始 的 ， 而 经 过 父 类 的 封装 ， 
LoadTimeWeaverBeanDefinitionParser 类 的 核心 实现 


AEE FS Bl] y doParse 20H, OF: 





protected void doParse(Element element, ParserContext parserCon 
text, BeanDefinition 
Builder builder) { 

builder.setRole(BeanDefinition.ROLE INFRASTRUCTURE); 


if (isAspectJWeavingEnabled 


(element.getAttribute(ASPECTJ WEAVING ATTRIBUTE), parserContext 
)) i 

RootBeanDefinition weavingEnablerDef - new RootBea 
nDefinition(); 

// ASPECTJ. WEAVING ENABLER CLASS NAME = 
// "org.Springframework.context.weaving.As 

pectJWeavingEnabler"; 

weavingEnablerDef.setBeanClassName(ASPECTJ WEAVING 
. ENABLER CLASS NAME); 


parserContext.getReaderContext().registerWithGener 
atedName (weavingEnablerDef); 


if (isBeanConfigurerAspectEnabled 


(parserContext.getReaderContext().getBean 
ClassLoader())) { 

new SpringConfiguredBeanDefinitionParser().par 
se(element, parserContext); 


j 
3 








其 实 之 前 在 分 析 动 态 AOP 也 就 是 在 分 析 配 置 
<aop:aspectj-autoproxy /> 中 已 经 提 到 了 目 定 义 配 置 
的 解析 流程 ， 对 于 <aop:aspectj-autoproxy/> 的 解析 
无 非 是 以 标签 作为 标志 ， 进 而 进行 相关 处 理 类 的 注 
册 ， 那 么 对 于 目 定 义 标签 <context:load-time-weaver 





/> 其 实 是 起 到 了 同样 的 作用 。 


上 面 函 数 的 核心 作用 其 实 就 是 注册 一 个 对 于 
ApectJ A TE 2S org.Springframework.context. 
weaving.AspectJWeavingEnabler， 它 的 注册 流程 总 


结 起 来 如 下 。 
1. BIA AspectJ. 


之 前 虽然 反复 提 到 了 在 配置 文件 中 加 入 了 
<context:load-time-weaver/> 便 相当 于 加 入 了 AspectJ 
开关 。 但 是 ， 并 不 是 配置 了 这 个 标签 就 意味 着 开局 
了 AspectJ 功 能 ， 这 个 标签 中 还 有 一 个 属性 aspectj- 
weaving， 这 个 属性 有 3 个 备 选 值 ，on、off 和 

















autodetect， 默 认为 autodetect， 也 就 是 说 ， 如 果 我 们 
只 是 使 用 了 <context:load-time-weaver/ >， 那 么 
Spring 会 帮助 我 们 检测 是 否 可 以 使 用 AspectJ 功 能 ， 
而 检测 的 依据 便 是 文件 META-INF/aop.xml 是 否 存 
在 ， 看 看 在 Spring 中 的 实现 方式 。 


protected boolean isAspectJWeavingEnabled(String value, ParserC 
ontext parserContext) { 
if ("on".equals(value)) { 
return true; 








} 
else if ("off".equals(value)) { 
return false; 
} 
else ( 
// 自 动 检测 
ClassLoader cl = parserContext.getReaderContext(). 
getResourceLoader(). 
getClassLoader(); 
return (cl.getResource(AspectJWeavingEnabler.ASPEC 
TJ. AOP XML RESOURCE) !- null); 


j 





2:8 
org.Springframework.context.weaving.AspectJWeaving 
封装 在 BeanDefinition 中 注册 。 


当 通 过 AspectJ 功 能 验证 后 便 可 以 进行 
AspectJWeavingEnabler 的 注册 了， 注册 的 方式 很 人 
单 ， 无 非 是 将 类 路 径 注册 在 新 初始 化 的 
RootBeanDefinition 中 ， 在 RootBeanDefinition 的 获取 





时 会 转换 成 对 应 的 class。 


管 在 init 方 法 中 注册 了 
AspectJWeavingEnabler， 但 是 对 于 标签 本 里 Spring 
也 会 以 bean 的 形式 保存 ， 也 就 是 当 Spring 解 析 到 
«context:load-time-weaver/» Ek 25 AY Hh] Rt 27 P7 
个 bean， 而 这 个 bean 中 的 信息 是 什么 呢 ? 














在 LoadTimeWeaverBeanDefinitionParser 类 中 有 


这 样 的 函数 : 


@Override 
protected String getBeanClassName(Element element) { 
if (element.hasAttribute(WEAVER_CLASS ATTRIBUTE 


return element.getAttribute(WEAVER CLASS ATTRIBUTE 


return DEFAULT_LOAD_TIME_WEAVER_CLASS_NAME 





@Override 
protected String resolveId(Element element, AbstractBeanDefinit 
ion definition, 
ParserContext parserContext) { 
return ConfigurableApplicationContext.LOAD TIME WEAVER 
. BEAN. NAME 





其 中 ， 可 以 看 到 : 


WEAVER CLASS ATTRIBUTE-"weaver-class" 

DEFAULT LOAD TIME WEAVER CLASS NAME = 
"org.Springframework.context.weaving.DefaultContex 

tLoadTimeWweaver"; 





ConfigurableApplicationContext.LOAD TIME WEAVER BEAN NAME-"load 
TimeWeaver" 





WEU EA fa Se 128 7b ay DHE WT, “4Spring 
在 读 取 到 自 定 义 标签 <context:load-time-weaver/ > 后 
会 产生 一 个 bean， 而 这 个 bean 的 id 为 
loadTimeWeaver, class 为 
org.Springframework.context.weaving. 
DefaultContextLoadTimeWeaver， 也 就 是 完成 了 
DefaultContextLoadTimeWeaver 类 的 注册 。 


完成 了 以 上 的 注册 功能 后 ， 并 不 意味 这 在 
Spring F Wè PJ LEH AspectJ 了， 因为 我 们 还 有 一 个 
AR cR SEHEN I. Ne 
LoadTimeWeaverAwareProcessor 的 注册 。 在 
AbstractApplicationContext 中 的 prepareBeanFactory 


六 数 中 有 这 样 一 段 代 人 码 : 














// 增 加 对 AspectJ 的 支持 
if (beanFactory.containsBean(LOAD TIME WEAVER BEAN NAM 


E)) 1 


beanFactory.addBeanPostProcessor(new LoadTimeWeave 
rAwareProcessor 
(beanFactory)); 

// Set a temporary ClassLoader for type matching. 


beanFactory.setTempClassLoader(new ContextTypeMatc 
hClassLoader (beanFactory. getBeanClassLoader())); 
} 


在 AbstractApplicationContext 中 的 
prepareBeanFactory FK 2 f E 5-88 4] A R s] FH] 
的 ， 也 残 是 说 只 有 注册 了 
LoadTimeWeaverAwareProcessor 才 会 激活 整个 
AspectJ HJ DJ BÉ o 


7.5.3 WRA 


当 我 们 完成 了 所 有 的 AspectJ 的 准备 工作 后 便 可 
以 进行 织 入 分 析 了 ， 前 先 还 是 从 


LoadTimeWeaverAwareProcessor 开 始 。 


LoadTimeWeaverAwareProcessor 实 现 
BeanPostProcessor 方 法 ， 那 么 对 于 
BeanPostProcessor 接 口 来 讲 ， 
postProcessBeforeInitialization 与 
postProcessAfterInitialization 有 着 其 特殊 音义， 也 就 
是 说 在 所 有 bean 的 初始 化 之 前 与 之 后 都 会 分 别 调用 
对 应 的 方法 ， 那 么 在 
LoadTimeWeaverAwareProcessor 中 的 
postProcessBeforeInitialization 函 数 中 完成 了 什么 样 
Ho BEG ? 





public Object postProcessBeforeInitialization(Object bean, Stri 
ng beanName) throws 
BeansException ( 
if (bean instanceof LoadTimeWeaverAware) { 
LoadTimeweaver ltw - this.loadTimeWeaver; 
if (ltw == null) { 
Assert.state(this.beanFactory !- null, 
"BeanFactory required if no LoadTimeWe 
aver explicitly specified"); 
ltw = this.beanFactory.getBean( 
ConfigurableApplicationContext.LOAD TI 
ME WEAVER BEAN NAME, 
LoadTimeWweaver.class); 


((LoadTimeWeaverAware) bean).setLoadTimeWweaver(ltw 


); 


j 


return bean; 





我 们 综合 之 前 讲解 的 所 有 信息 ， 将 所 有 相关 信 
姑 串 联 起 来 一 起 分 析 这 个 函数 。 


在 LoadTimeWeaverAwareProcessor 中 的 
postProcessBeforeInitialization 函 数 中 ， 因 为 最 开始 
EASE FY NTE FE IK 7 Ji ADH AS A AT 
LoadTimeWeaverA wareZ 4! 型 的 bean 起 作用 ， 而 纵 观 
所 有 的 bean， 实 现 LoadTimeWeaver 接 口 的 类 只 有 
AspectJWeavingEnabler. 


当 在 Spring 中 调用 AspectJWeavingEnabler 时 , 
this.loadTimeWeaver 疝 未 被 初始 化 ， 那 么 ， 会 直接 
调用 beanFactory.getBean 方 法 获取 对 应 的 





DefaultContextLoadTimeWeaver 类 型 的 bean， 并 将 
其 设置 为 AspectJWeavingEnabler 类 型 bean 的 
loadTimeWeaver 属 性 中 。 当 然 
AspectJWeavingEnabler 同 样 实 现 了 
BeanClassLoaderAware 以 及 Ordered 接 口 ， 实 现 
BeanClassLoaderAware 接 口 保证 了 在 bean 初 始 化 的 
时 候 调 用 AbstractAutowireCapableBeanFactory 的 
invokeAwareMethods 的 时 候 将 beanClassLoader 赋 值 
给 当前 类 。 而 实现 Ordered 接 口 则 保证 在 实例 化 bean 
时 当前 bean 会 被 最 先 初 始 化 。 


而 DefaultContextLoadTimeWeaver 类 叉 同 时 实 
现 了 LoadTimeWeaver、BeanClassLoaderAware 以 及 
DisposableBean。 其 中 DisposableBean 接 口 保证 在 
bean 销 毁 时 会 调用 destroy 方 法 进行 bean 的 清理 ， 而 
BeanClassLoaderAware 接 口 则 保证 在 bean 的 初始 化 
调用 AbstractAutowireCapable- BeanFactory 的 
invokeAwareMethods 时 调用 setBeanClassLoader 方 
eae 











public void setBeanClassLoader(ClassLoader classLoader) { 
LoadTimeWeaver serverSpecificLoadTimeWeaver = createSe 
rverSpecificLoadTimeWeaver (classLoader); 
if (serverSpecificLoadTimeWeaver !- null) ( 
if (logger.isInfoEnabled()) ( 
logger.info("Determined server-specific load-t 
ime weaver: " + 


serverSpecificLoadTimeWeaver.getClass( 
).getName( )); 


this.loadTimeWeaver - serverSpecificLoadTimeWeaver 
/ 
jelse if (InstrumentationLoadTimeWeaver .isInstrumentat 
ionAvailable 


0) 1 





// 检 查 当 前 虚拟 机 中 的 Instrumentation 实 例 是 否 可 用 
logger.info("Found Spring's JVM agent for instrume 
ntation"); 
this.loadTimeWeaver - new InstrumentationLoadTimeW 
eaver(classLoader); 


jelse ( 
try { 
this.loadTimeWeaver = new ReflectiveLoadTimeWe 
aver(classLoader); 
logger.info("Using a reflective load-time weav 
er for class loader: " + 


this.loadTimeWeaver.getInstrumentableC 
lassLoader(). getClass(). 
getName()); 


catch (IllegalStateException ex) { 
throw new IllegalStateException(ex.getMessage( 
) + " Specify a custom LoadTimeWeaver or start your " + 
"Java virtual machine with Spring's ag 
ent: -javaagent:org. 
Springframework.instrument.jar"); 


} 


I 





EH IF] e AH A — 8) RE 2 SCIL EIR BE 
的 代码 : 


this.loadTimeWeaver = new InstrumentationLoadTimeWeaver(classLo 
ader); 





这 人 句 代 人 码 不 仅仅 是 实例 化 了 一 个 
InstrumentationLoadTimeWeaver 类 型 的 实例 ， 而 且 
在 实例 化 过 程 中 还 做 了 一 些 额 外 的 操作 。 


在 实例 化 的 过 程 中 会 对 当前 的 
this.instrumentation 属 性 进行 初始 化 ， 而 初始 化 的 代 
fü F: this.instrumentation = getInstrumentation(), 
也 就 是 说 在 InstrumentationLoadTimeWeaver 实 例 化 
后 其 属性 Instrumentation 已 经 被 初始 化 为 代表 着 当 
前 虚拟 机 的 实例 了 。 综 合 我 们 讲 过 的 例子 ， 对 于 注 
册 转 换 器 ， 如 addTransformer 函 数 等 ， 便 可 以 直接 
使 用 此 属性 进行 操作 了 。 


也 束 是 经 过 以 上 程序 的 处 理 后 ， 在 Spring 中 的 
bean 之 间 的 关系 如 下 。 


。 AspectJWeavingEnabler 类 型 的 bean 中 的 
loadTimeWweaver 属 性 被 初始 化 为 Default 
ContextLoadTimeWeaver 类 型 的 bean。 

。DefaultContextLoadTimeWeaver 类 型 的 bean 中 的 
loadTimeWeaver 属 性 被 初始 化 为 


InstrumentationLoadTimeWeaver. 








为 AspectJWeavingEnabler 类 同样 实现 了 
BeanFactoryPostProcessor， 所 以 当 所 有 bean 解 析 结 
束 后 会 调用 其 postProcessBeanFactory 方 法 。 





public void postProcessBeanFactory(ConfigurableListableBeanFact 
ory beanFactory) throws BeansException { 
enableAspect JWeaving 


(this.loadTimeWeaver, this.beanClassLoader); 


j 


public static void enableAspectJWeaving(LoadTimeWeaver weaverTo 
Use, ClassLoader 
beanClassLoader) { 
if (weaverToUse -- null) ( 
// 此 时 已 经 被 初始 化 为 DefaultContextLoadTimeWeaver 
if (InstrumentationLoadTimeWeaver.isInstrumentatio 
nAvailable()) { 
weaverToUse - new InstrumentationLoadTimeWeave 
r(beanClassLoader); 
} 
else ( 
throw new IllegalStateException("No LoadTimeWe 
aver available"); 


j 


// 使 用 DefaultCcontextLoadTimeWeaver 类 型 的 bean 中 的 loadTimeWeaver 
属性 注册 转换 器 
weaverToUse.addTransformer(new AspectJClassBypassingCl 
assFileTransformer 


n 





( 
j 


private static class AspectJClassBypassingClassFileTransformer 
implements Class 
FileTransformer { 


new ClassPreProcessorAgentAdapter( ))); 


private final ClassFileTransformer delegate; 


public AspectJClassBypassingClassFileTransformer(ClassFileTrans 
former delegate) { 
this.delegate - delegate; 


5 


public byte[] transform(ClassLoader loader, String className, C 
lass<?> classBeingRedefined, 
ProtectionDomain protectionDomain, byte[] classfileBuffer) thro 


ws IllegalClassFormatException { 


if (className.startsWith("org.aspectj") || classNa 
me.startsWith 
("org/aspectj")) { 
return classfileBuffer; 









































} 
// 委 托 给 AspectJ 代 理 继续 处 理 
return this.delegate.transform(loader, className, 
classBeingRedefined, 
protectionDomain, classfileBuffer); 


j 
j 





AspectJClassBypassingClassFileTransformerf*] fF 
用 仅仅 是 告诉 AspectJ 以 org.aspectj 开 头 的 或 者 
org/aspectj 开 头 的 类 不 进行 处 理 。 
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Br ”数据 库 连 接 JDBC 


JDBC (Java Data Base Connectivity, JavaZi4 
库 连 接 ) 是 一 种 用 于 执行 SQL 语句 的 Java API, FY 
以 为 多 种 关系 数据库 提供 统一 访问 ， 它 由 一 组 用 
Java 语 言 编 号 的 类 和 接口 组 成 。JDBC 为 数据 库 开 发 
人 员 提 供 了 一 个 标准 的 API， 据 此 可 以 构建 更 高 级 
的 工具 和 接口 ， 使 数据 库 开 有 人员 能 够 用 纯 Java 
API 编 号 数据 库 应 用 程序 ， 并 且 可 路 平台 运行 ， 并 
且 不 受 数据 库 供 应 丙 的 限制 。 


JDBC 连 接 数 据 库 的 流程 及 其 原理 如 下 。 


1. 在 开发 环境 中 加 载 指 定数 据 库 的 驱动 程 
厅 。 接 下 来 的 实验 中 ， 使 用 的 数据 库 是 MySQL， 所 
以 需要 去 下 载 MySQL 文 持 JDBC 的 驱动 程序 (最 新 
的 版 本 是 mysql-connector-java-5.1.18- bin.jar) ， 将 
下 载 得 到 的 驱动 程序 加 载 进 开 发 环境 中 〈 开 友 环 境 
是 MyEclipse， 有 具体 示例 时 会 讲解 如 何 加 载 ) 。 


2. 在 Java 程 序 中 加 载 驱 动 程 序 。 在 Java 程 序 
中 ， 可 以 通过 “Class.forName(" 指 定数 据 库 的 驱动 程 
序 ")” 的 方式 来 加 载 添 加 到 开发 环境 中 的 驱动 程序 ， 








例如 加 载 MySQL 的 数据 驱动 程序 的 代码 为 


Class.forName(" com.mysgl.jdbc.Driver"). 


3. 创建 数据 连接 对 象 。 通过 DriverManager3、 
创建 数据 库 连 接 对 象 Connection。DriverManager 类 
作用 于 Java 程 序 和 JDBC 驱 动 程序 之 间 ， 用 于 检查 所 
加 载 的 驱动 程序 是 否 可 以 建 并 连接 ， 然 后 通过 它 的 
getConnection 方 法 根据 数据 库 的 URL、 用 户 名 和 秘 
人 码 ， 创 建 一 个 JDBC Connection 对 象 ， 例 如 : 
Connection connection = 
Drvo anager geiConnection( E #240 45 Pe AJURL", 

"用 户 名 ", "密码 ")。 其 中 ，URL= 协 议 名 +IP 地 址 

(域名 ) + 端口 + 数据 库 名 称 ; 用 户 名 和 和 密码 是 指 登 
录 数 据 库 时 所 使 用 的 用 户 名 和 密码 。 具 体 示 例 创 建 
MySQL 的 数据 库 连 接 代 码 如 下 : 











Connection connectMySQL = a geiConnection("jdbc 
:mysql://localhost:3306/ myuser", "root" ,"root" ); 





4. 创建 Statement 对 象 。Statement 类 的 主要 是 
用 于 执行 静态 SQL 语句 并 返回 它 所 生成 结果 的 对 
象 。 通 过 Connection 对 象 的 createStatement() 方 法 可 
以 创建 一 个 Statement 对 象 。 例 如 : Statement 
statament = connection.createStatement()。 上 基体 示例 


创建 Statement 对 象 代码 如 下 : 








Statement statamentMySQL -connectMySQL.createStatement(); 


5. 调用 Statement 对 象 的 相关 方法 执行 相对 应 
的 SQL 语句 。 通 过 execuUpdate() 方 法 来 对 数据 更 
新 ， 包 括 插 入 和 删除 等 操作 ， 例 如 同 staff 表 中 插入 





statement.excuteUpdate( "INSERT INTO staff(name, age, sex,add 
ress, depart, worklen,wage)" + " VALUES ('Tom1', 321, 'M', 'chi 
/ 


na','Personnel','3','3000' ) ") 





通过 调用 Statement 对 象 的 executeQuery0 方 法 进 
行 数据 的 查询 ， 而 查询 结果 会 得 到 ResulSet 对 象 ， 
ResulSet 表 示 执 行人 查询 数据 库 后 返回 的 数据 的 集 
合 ，ResulSet 对 和 象 具 有 可 以 指 癌 当前 数据 行 的 指 
针 。 通 过 该 对 象 的 nextO 方 法 ， 使 得 指针 指 回 下 一 
行 ， 然 后 将 数据 以 列 号 或 者 字段 名 取出 。 如 果 当 
next() 方 法 返回 null， 则 表示 下 一 行 中 没有 数据 存 
在 。 使 用 示例 代码 如 下 : 





ResultSet resultSel = statement.executeQuery( "select * from st 
aff" ); 





6. 关闭 数据 库 连接 。 使 用 完 数 据 库 或 者 不 需 
要 访问 数据 库 时 ， 通 过 Connection 的 close() 方法 及 
时 关闭 数据 连接 。 


8.1 Spring 连接 数据 库 程 序 实现 
(JDBC) 


Spring 中 的 JDBC 连 接 与 直接 使 用 JDBC 去 连接 
还 是 有 所 差别 的 ，Spring 对 JDBC 做 了 大 量 封 装 ， 消 
除了 元 余 代 人 码 ， 使 得 开发 量 大 大 减 小 。 下 面 通过 一 
个 小 例子 计 大 家 人 简单 认识 Spring 中 的 JDBC 操 作 。 





1. 创建 数据 表 结 构 


CREATE TABLE 'user' ( 
'id' int(11) NOT NULL auto increment, 


'name' varchar(255) default NULL, 
'age' int(11) default NULL, 
'sex' varchar(255) default NULL, 
PRIMARY KEY ('id') 

) ENGINE-InnoDB DEFAULT CHARSET=utf8; 





2. 创建 对 应 数据 表 的 PO 


public class User { 


private int id; 

private String name; 

private int age; 
private String sex; 





// 省 略 sSet/get 方 法 


j 





3. 创建 表 与 实体 间 的 映射 


public class UserRowMapper implements RowMapper { 


QOverride 
public Object mapRow(ResultSet set, int index) throws SQLEx 
ception ( 
User person = new User(set.getInt("id"), set.getString( 
"name"), set 
.getInt("age"), set.getString("sex")); 
return person; 





4. 创建 数据 操作 接口 


public interface UserService ( 
public void save(User user); 


public List<User> getUsers(); 





5. 创建 数据 操作 接口 实现 类 





public class UserServicelmpl implements UserService { 


private JdbcTemplate 
jdbcTemplate; 


// 设置 数据 源 


public void setDataSource(DataSource dataSource) ( 


this.jdbcTemplate - new JdbcTemplate(dataSource); 
} 


public void save(User user) { 
jdbcTemplate.update("insert into user(name,age,sex)valu 
es(?,?,?)", 
new Object[] { user.getName(), user.getAge(), 
user.getSex() }, new int[] { java.sql.T 
ypes.VARCHAR, 
java.sql.Types.INTEGER, java.sql.Types. 
VARCHAR }); 


j 


@SuppressWarnings("unchecked" ) 
public List<User> getUsers() { 
List<User> list = jdbcTemplate.query("select * from use 
r", new UserRowMapper( )); 
return list; 





6. 创建 Spring 配置 文件 





<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.Springframework.org/schema/ 

beans 


http://www.Springframework.org/schema/beans/Spring- 
beans-2.5.xsd 
Ws 
<!- -配置 数据 源 --> 
«bean id="dataSource" class="org.apache.commons.dbcp.Basic 
DataSource" 
destroy-method="close"> 
<property name="driverClassName" value="com.mysql.jdbc 
.Driver" /> 
«property name-"url" 
value="jdbc:mysql://localhost:3306/lexueba" /> 














«property name="username" value="root" /> 

«property name="password" value="hao0jia0421xixi" /> 

«1-- 连接 池 启 动 时 的 初始 值 --> 

«property name="initialSize" value="1" /> 

«1-- 连接 池 的 最 大 值 --> 

<property name="maxActive" value="300" /> 

«1-- 最 大 空闲 值 . 当 经 过 一 个 高 峰 时 间 后 ， 连 接 池 可 以 慢 慢 将 已 经 用 不 到 
的 连接 慢 慢 释 放 一 部 分 ， 一 直 减 少 到 maxIdle 为 止 --> 

«property name="maxIdle" value="2" /> 

«1-- 最 小 空间 值 .当空 用 的 连接 数 少 于 阀 值 时 ， 连 接 池 就 会 预 申请 去 一 些 
连接 ， 以 免 洪 峰 来 时 来 不 及 申请 --> 

«property name="minIdle" value="1" /> 

</bean> 























«1-- 配置 业务 bean: PersonServiceBean --> 

«bean id="userService" class="service.UserServiceImpl"> 
«1-- 向 属性 dataSource 注 入 数据 源 --> 
<property name="dataSource" ref="dataSource"></propert 





y> 


</bean> 
</beans> 





7. 测试 





public class SpringJDBCTest { 


public static void main(String[] args) { 
ApplicationContext act = new ClassPathXmlApplicationCo 
ntext("bean.xml"); 


UserService userService - (UserService) act.getBean("u 
serService"); 

User user - new User(); 

user .setName(" 张 三 ")，; 

user.setAge(20); 
user.setSex(" 5j" 
// 保存 一 条 记录 
userService.save(user); 

















List«User» personi = userService.getUsers(); 
System.out .print1Ln("++++++++ 得 到 所 有 User'" ) 








for (User person2 : person1) ( 
System.out.println(person2.getId() + " " + person 
2.getName() 
" + person2.getAge() +" " + person 
2.getSex()); 
} 


} 
j 





8.2 ”save/update 功 能 的 实现 


我 们 以 上 面 的 例子 为 基础 开始 分 析 Spring 中 对 
JDBC 的 文 持 ， 首 先 寻 找 整 个 功能 的 切入 点 ， 在 示 
例 中 我 们 可 以 看 到 所 有 的 数据 库 操 作 都 封装 在 了 
UserServiceImpl 中 ， 而 UserServiceImpl 中 的 所 有 数 
据 库 操作 又 以 其 内 部 属性 jdbcTemplate 为 基础 。 这 
个 jdbcTemplate 可 以 作为 源码 分 析 的 切入 点 ， 我 们 
一 起 看 看 它 是 如 何 实现 又 是 如 何 被 初始 化 的 。 


在 UserServiceImpl 中 jdbcTemplate 的 初始 化 是 
从 setDataSource 函 数 开 始 的 ，DataSource 实 例 通 过 
参数 注入 ，DataSource 的 创建 过 程 是 引入 第 三 方 的 
连接 闻 ， 这 里 不 做 过 多 介绍 。DataSource 是 整个 数 
据 库 操作 的 基础 ， 里 面 封 狼 了 整个 数据 库 的 连接 信 
恩 。 我 们 首先 以 保存 实体 类 为 例 进 行 代 码 跟 踩 。 


public void save(User user) ( 
jdbcTemplate.update( 











"insert into user(name,age,sex)values(?,?,?)', 
new Object[] { user.getName(), user.getAge(), 


user.getSex() }, new int[] { java.sql.T 
ypes.VARCHAR, 


java.sql.Types.INTEGER, java.sql.Types. 


VARCHAR }); 
} 








对 于 保存 一 个 实体 类 来 讲 ， 在 操作 中 我 们 只 需 
要 提供 SQL 语句 以 及 语句 中 对 应 的 参数 和 参数 类 
型 ， 其 他 操作 便 可 以 交 由 Spring 来 完成 了 ， 这 些 工 
作 到 底 包 括 什 么 呢 ? 进入 jdbcTemplate 中 的 update 方 
ik. 


public int update(String sql, Object[] args, int[] argTypes) th 
rows DataAccessException { 


return update 


(sql, newArgTypePreparedStatementSetter 
(args, argTypes)); 
} 


public int update(String sql, PreparedStatementSetter pss) thro 
ws DataAccessException { 


return update 


(new SimplePreparedStatementCreator 


(sql), pss); 
J 





进入 update 方 法 后 ，Spring 并 不 是 急于 进入 核 


心 处 理 操 作 ， 而 是 先 做 足 准备 工作 ， 使 用 
ArgTypePreparedStatementSetter 对 参数 与 参数 类 型 
进行 封装 ， 同 时 又 使 用 Simple PreparedStatement 
Creator 对 SQL 语句 进行 封装 。 至 于 为 什么 这 么 封 
7, PAR PRS. 


经 过 了 数据 封装 后 便 可 以 进入 了 核心 的 数据 处 
HIRIG Tos 








protected int update(final PreparedStatementCreator psc, final 
PreparedStatementSetter pss) 
throws DataAccessException { 


logger .debug("Executing prepared SQL update"); 
return execute 


(psc, new PreparedStatementCallback<Integer>() { 
public Integer doInPreparedStatement(PreparedState 
ment ps) throws 
SQLException ( 
try { 
if (pss !- null) ( 
// 设 置 PreparedStatement 所 需 的 全 部 参数 
pss.setValues(ps); 


int rows = ps.executeUpdate(); 
if (logger.isDebugEnabled()) { 
logger.debug("SQL update affected " + 
rows * " rows"); 


j 


return rows; 


} 
finally { 
if (pss instanceof ParameterDisposer) { 
((ParameterDisposer) pss).cleanupParam 
eters(); 


J): 


如 果 读 者 了 解 过 其 他 操作 方法 ， 可 以 知道 
execute 方 法 是 最 基础 的 操作 ， 而 其 他 操作 比如 
update、query 等 方法 则 是 传 入 不 同 的 
PreparedStatementCallback BOK 3447 A» [8] H]32 48. o 








8.2.1 ”基础 方法 execute 


execute 作 为 数据 库 操作 的 核心 入 口 ， 将 大 多 数 
数据 库 操 作 相同 的 步 又 统一 封装 ， 而 将 个 性 化 的 操 
作 使 用 参数 PreparedStatementCallback 进 行 回调 。 








public «T» T execute(PreparedStatementCreator psc, PreparedStat 
ementCallback<T> action) 
throws DataAccessException { 


Assert.notNull(psc, "PreparedStatementCreator must not 
be null"); 
Assert.notNull(action, "Callback object must not be nu 
l1"); 
if (logger.isDebugEnabled()) { 
String sql = getSql(psc); 
logger .debug(" Executing prepared SQL statement" + 
(sql != null ? " [" + sql + "]" j 
// 获 取 数 据 库 连 接 


Connection con = DataSourceUtils.getConnection 





(getDataSource()); 
PreparedStatement ps = null; 
try { 


Connection conToUse - con; 
if (this.nativeJdbcExtractor !- null && 
this.nativeJdbcExtractor.isNativeConnectio 
nNecessaryForNative 
PreparedStatements()) ( 
conToUse - this.nativeJdbcExtractor.getNativeC 
onnection(con); 
} 
ps = psc.createPreparedStatement (conToUse); 
// 应 用 用 户 设 定 的 输入 参数 
applyStatementSettings 





(ps); 
PreparedStatement psToUse - ps; 
if (this.nativeJdbcExtractor !- null) ( 
psToUse - this.nativeJdbcExtractor.getNativePr 
eparedStatement(ps); 











} 
// 调 用 回调 函数 
T result = action.doInPreparedStatement(psToUse); 
handleWarnings 
(ps); 
return result; 
} 
catch (SQLException ex) { 
// 释 放 数 据 库 连接 避免 当 异常 转换 器 没有 被 初始 化 的 时 候 出 现 潜在 
的 连接 池 死 锁 





if (psc instanceof ParameterDisposer) { 
((ParameterDisposer) psc).cleanupParameters(); 

} 

String sql = getSql(psc); 

psc = null; 

JdbcUtils.closeStatement(ps); 

ps = null; 

DataSourceUtils.releaseConnection 


(con, getDataSource()); 
con = null; 
throw getExceptionTranslator().translate("Prepared 
StatementCallback", sql, ex); 
} 
finally { 
if (psc instanceof ParameterDisposer) { 
((ParameterDisposer) psc).cleanupParameters(); 


JdbcUtils.closeStatement(ps); 
DataSourceUtils.releaseConnection(con, getDataSour 


ce()); 





以 上 方法 对 第 用 操作 进行 了 封装 ， 包 括 如 下 几 
项 内 容 。 


1. 获取 数据 库 连 接 


获取 数据 库 连 接 也 并 非 直 接 使 用 
dataSource.getConnection() 方 法 那么 人 简单， 同样 也 考 
虑 了 诸多 情况 。 





public static Connection doGetConnection(DataSource dataSource ) 
throws SQLException { 


Assert.notNull(dataSource, "No DataSource specified"); 


ConnectionHolder conHolder = (ConnectionHolder) Transa 
ctionSynchronization 
Manager .getResource(dataSource) ; 
if (conHolder != null && (conHolder.hasConnection() || 
conHolder.isSynchronized 
WithTransaction())) { 
conHolder.requested(); 
if (!conHolder.hasConnection()) { 


logger.debug("Fetching resumed JDBC Connection 
from DataSource"); 


conHolder.setConnection(dataSource.getConnecti 


on()); 


return conHolder.getConnection(); 


logger.debug("Fetching JDBC Connection from DataSource 
2); 


Connection con - dataSource.getConnection(); 


// 当 前 线程 支持 同步 
if (TransactionSynchronizationManager.isSynchronizatio 
nActive()) { 
logger.debug("Registering transaction synchronizat 
ion for JDBC Connection"); 
// 在 事务 中 使 用 同一 数据 库 连 接 
ConnectionHolder holderToUse = conHolder; 
if (holderToUse -- null) ( 
holderToUse - new ConnectionHolder(con); 








j 


else ( 
holderToUse.setConnection(con); 


} 

// 记 录 数 据 库 连接 
holderToUse.requested(); 
TransactionSynchronizationManager.registerSynchron 





ization( 
new ConnectionSynchronization(holderToUse, 
dataSource)); 
holderToUse.setSynchronizedWithTransaction(true); 
if (holderToUse != conHolder) { 
TransactionSynchronizationManager.bindResource 
(dataSource, holderToUse); 


i; 
} 


return con; 














在 数据 库 连 接 方面 ，Spring 主 要 考虑 的 是 关于 


事务 方面 的 处 理 。 基 于 事务 处 理 的 特殊 性 ，Spring 
的 数据 库 操 作 都 是 使 用 同一 个 事务 
连接 。 











2. 应 用 用 户 设 定 的 输入 参数 


protected void applyStatementSettings(Statement stmt) throws SQ 
LException ( 
int fetchSize - getFetchSize(); 
if (fetchSize > 0) { 
stmt.setFetchSize(fetchSize); 


j 


int maxRows - getMaxRows(); 


if (maxRows > 0) { 
stmt.setMaxRows (maxRows ) ; 
} 
DataSourceUtils.applyTimeout(stmt, getDataSource(), ge 
tQueryTimeout()); 








setFetchSize 了 最 主要 是 为 了 减少 网 络 交 互 次 数 设 
计 的 。 访 问 ResultSet 时 ， 如 果 它 每 次 只 从 服务 器 上 
读 取 一 行 数据 ， 则 会 产生 大 量 的 开销 。setFetchSize 
的 意思 是 当 调 用 rs.next 时 ，ResultSet 会 一 次 性 从 服 
务 器 上 取得 多 少 行 数 据 回 来 ， 这 样 在 下 次 rs.next 
时 ， 它 可 以 直接 从 内 存 中 获取 数据 而 不 需要 网 络 交 
互 ， 提 高 了 效率 。 这 个 设置 可 能 会 被 某 些 JDBC 驱 
动 忽略 ， 而 且 设 置 过 大 也 会 造成 内 存 的 上 升 。 


setMaxRows 将 此 Statement 对 象 生 成 的 所 有 
ResultSet 对 象 可 以 包含 的 最 大 行 数 限制 设置 为 给 定 
数 。 




















3. 调用 回调 函数 


处 理 一 些 通 用 方法 外 的 个 性 化 处 理 , 也 吏 是 
PreparedStatementCallback 类 型 的 参数 的 
doInPreparedStatement 方 法 的 回调 。 


4. SE AREE 


protected void handleWarnings(Statement stmt) throws SQLExcepti 
on { 
// 当 设置 为 忽略 警告 时 只 尝试 打印 日 志 
if (isIgnoreWarnings()) { 
if (logger.isDebugEnabled()) { 
// 如 果 日 志 开 启 的 情况 下 打印 日 志 
SQLWarning warningToLog = stmt.getWarnings(); 
while (warningToLog !- null) { 
logger.debug("SQLWarning ignored: SQL stat 
e '" + warningToLog. 
getSQLState() + "', error code '" + 
warningToLog.getErrorCode() + "', 





message [" + warningToLog. 
getMessage() + "]|"); 
warningToLog = warningToLog.getNextWarning 


else { 
handleWwarnings(stmt.getWarnings()); 


J 





这 里 用 到 了 一 个 类 SQLWarning，SQLWarning 
提供 关于 数据 库 访 n 警告 信息 的 异常 。 这 些 警告 直 
接 链 接 到 导致 报告 警告 的 方法 所 在 的 对 象 。 Ž 
以 从 Connection、Statement 和 ResultSet 对 象 中 获 




















得 。 试 图 在 已 经 天 闭 的 连接 上 获取 警告 将 导致 抛 出 
异常 。 类 似 地 ， 试 图 在 已 经 关闭 的 语句 上 或 已 经 关 
闭 的 结束 集 上 获取 警告 也 将 导致 地 出 异常 。 注 意 ， 
关闭 语句 时 还 会 关闭 它 可 能 生成 的 结果 集 。 


很 多 人 不 是 很 理解 什么 情况 下 会 产生 警告 而 不 
是 异常 ， 在 这 里 给 读者 提示 个 最 常见 的 警告 
DataTruncation: DataTruncation 直 接 继承 
SQLWarmning， 由 于 茶 种 原因 意外 地 截断 数据 值 时 


会 以 DataTruncation 警告 形式 报告 异常 。 


对 于 警告 的 处 理 方式 并 不 是 直接 抛 出 卉 冲 ， 出 
现 警 告 很 可 能 会 出 现 数据 错误 ， 但 是 ， 并 不 一 定 会 
影响 程 序 执行 ， 所 以 用 户 可 以 目 己 设置 处 理 管 告 的 
方式 ， 如 默认 的 古 忽略 敬告， 当 出 现 警 告 时 只 打印 
党 告 日 志 ， 而 为 一 种 方式 只 和 耳 接 抛 出 寞 第 。 





























5. 资源 释放 


数据 库 的 连接 释放 并 不 是 直接 调用 了 
Connection 的 API 中 的 close 方 法 。 考 虑 到 存在 事务 的 
情况 ， 如 果 当 前 线程 存在 事务 ， 那 么 说 明 在 当前 线 
程 中 存在 共用 数据 库 连 接 ， 这 种 情况 下 直接 使 用 
ConnectionHolder 中 的 released 方 法 进行 连接 数 减 
一 ， 而 不 是 真正 的 释放 连接 。 








public static void releaseConnection(Connection con, DataSource 
dataSource) { 


try { 


doReleaseConnection(con, dataSource); 
} 
catch (SQLException ex) { 
logger.debug("Could not close JDBC Connection", ex 


catch (Throwable ex) { 
logger .debug("Unexpected exception on closing JDBC 
Connection", ex); 
} 
} 
public static void doReleaseConnection(Connection con, Dat 
aSource dataSource) 
throws SQLException ( 
if (con == null) { 
return; 


j 


if (dataSource !- null) ( 

// 当 前 线程 存在 事务 的 情况 下 说 明 存 在 共用 数据 库 连 接 直接 使 用 Con 
nectionHolder 中 的 
// released 方 法 进行 连接 数 减 一 而 不 是 真正 的 释放 连接 

ConnectionHolder conHolder = (ConnectionHolder) Tr 
ansactionSynchronization 
Manager.getResource(dataSource); 

if (conHolder !- null && connectionEquals(conHolde 























r, con)) { 
// It's the transactional Connection: Don't cl 


ose it. 
conHolder.released(); 
return; 
} 
} 
if (!(dataSource instanceof SmartDataSource) || ((Smar 


tDataSource) dataSource). 
shouldClose(con)) { 

logger.debug("Returning JDBC Connection to DataSou 
rce"); 

con.close(); 


MEN 


8.2.2 Update 中 的 回调 函数 


PreparedStatementCallback 作 为 一 个 接口 ， 其 中 
只 有 一 个 函数 doInPreparedStatement， 这 个 函数 是 
用 于 调用 通用 方法 execute 的 时 候 无 法 处 理 的 一 些 个 
性 化 处 理 方 法 ， 在 update 中 的 函数 实现 : 


public Integer doInPreparedStatement(PreparedStatement ps) thro 
ws SQLException { 


try { 
if (pss != null) { 


// 设 置 PreparedStatement 所 需 的 全 部 参数 
pss.setValues(ps); 


} 
int rows = ps.executeUpdate(); 
if (logger.isDebugEnabled()) { 
logger.debug("SQL update affected " + 
rows * " rows"); 


return rows; 
} 
finally { 


if (pss instanceof ParameterDisposer) { 
((ParameterDisposer) pss).cleanupParam 





其 中 用 于 真正 执行 SQL 的 ps.executeUpdate 没 有 


太 多 需要 讲解 的 ， 因 为 我 们 平时 在 直接 使 用 JDBC 
方式 进行 调用 的 时 候 会 经 常 使 用 此 方法 。 但 是 ， 对 
于 设置 输入 参数 的 函数 pss.setValues (ps)， 我 们 有 必 
要 去 深入 研究 一 下 。 在 没有 分 析 源 码 之 前 ， 我 们 至 
少 可 以 知道 其 功能 ， 不 妨 再 回顾 下 Spring 中 使 用 
SQL 的 执行 过 程 ， 直 接 使 用 : 





jdbcTemplate.update("insert into user(name,age,sex)values(?,?,? 


new Object[] { user.getName(), user.getAge(), 
user.getSex() }, new int[] { java.sql.T 
ypes. VARCHAR, 
java.sql.Types.INTEGER, java.sql.Types. 
VARCHAR }); 





SQL 语句 对 应 的 参数 ， 对 应 参数 的 类 型 清晰 明 
了 ， 这 都 归功 于 Spring 为 我 们 做 了 封 逆 ， 而 真正 的 
JDBC 调 用 其 实 非常 楷 珊 ， 你 需要 这 么 做 : 





PreparedStatement updateSales = con.prepareStatement("inser 
t into user(name,age, 
sex)values(?,?,?)"); 
updateSales.setString(1, user.getName()); 


updateSales.setInt(2, user.getAge()); 
updateSales.setString(3, user.getSex()); 





AS EF Springzé f fe fo BST ee E TR IE] BTE 
NE? 


首先 ， 所 有 的 操作 都 是 以 pss.setValues(ps) 为 入 








口 的 。 还 记得 我 们 之 前 的 分 析 路 程 吗 ?这 个 pss 所 代 
表 的 当前 类 正 是 ArgPreparedStatementSetter。 其 中 
的 SetValues 如 下 : 





public void setValues(PreparedStatement ps) throws SQLException 


{ 


int parameterPosition = 1; 
if (this.args != null) { 
/ i FES EET DL BI e Pe 
for (int 1 = 0; i < this.args.length; i++) { 
Object arg = this.args[i]; 
// 如 果 是 集合 类 则 需要 进入 集合 类 内 部 递归 解析 集合 内 部 属性 
if (arg instanceof Collection && this.argTypes 
[i] != Types.ARRAY) { 
Collection entries - (Collection) arg; 
for (Iterator it - entries.iterator(); it. 









































hasNext();) { 
Object entry - it.next(); 
if (entry instanceof Object[]) { 
Object[] valueArray - ((0bject[])e 
ntry); 
for (int k = 0; k « valueArray.len 
gth; k++) { 
Object argValue = valueArray[k 
]; 
doSetValue(ps, parameterPositi 
on, this.argTypes[i], 
argValue); 
parameterPosition++; 


} 
}else { 
doSetValue(ps, parameterPosition, 
this.argTypes[i], entry); 


parameterPosition++; 
} 
}else { 


// 解 析 当 前 属性 
doSetValue 








(ps, parameterPosition, this.argTypes[i], arg); 


parameterPosition--; 





对 单个 参数 及 类 型 的 匹配 处 理 : 





protected void doSetValue(PreparedStatement ps, int parameterPo 
sition, int argType, 
Object argValue) 
throws SQLException ( 
StatementCreatorUtils.setParameterValue 


(ps, parameterPosition, argType, argValue); 
} 
public static void setParameterValue( 
PreparedStatement ps, int paramIndex, int sqlType, 
Object inValue) 
throws SQLException ( 


setParameterValueInternal 


(ps, paramIndex, sqlType, null, null, inValue); 
} 


private static void setParameterValueInternal ( 
PreparedStatement ps, int paramIndex, int sqlType, 
String typeName, Integer 
scale, Object inValue) 
throws SQLException { 


String typeNameToUse = typeName; 
int sqlTypeToUse = sqlType; 
Object inValueToUse = inValue; 


if (inValue instanceof SqlParameterValue) { 
SqlParameterValue parameterValue = (SqlParameterVa 
lue) inValue; 
if (logger.isDebugEnabled()) { 


logger.debug("Overriding type info with runtim 
e info from SqlParameterValue: 
column index " + paramIndex + 
", SQL type " + parameterValue.getSqlT 
ype() * 
", Type name " + parameterValue.getTyp 
eName( )); 


} 
if (parameterValue.getSqlType() != SqlTypeValue.TY 
PE UNKNOWN) { 
sqlTypeToUse = parameterValue.getSqlType(); 


if (parameterValue.getTypeName() != null) { 
typeNameToUse = parameterValue.getTypeName(); 


inValueToUse = parameterValue.getValue(); 


j 


if (logger.isTraceEnabled()) { 
logger.trace("Setting SQL statement parameter valu 

e: column index " + 
paramIndex + 

", parameter value [" + inValueToUse + 

"], value class [" + (inValueToUse !- null 
? inValueToUse. 
getClass().getName() : "null") + 

"], SQL type " + (sqlTypeToUse == SqlTypeV 
alue.TYPE UNKNOWN ? 
"unknown" : Integer.toString(sqglTypeToUse))); 


j 


if (inValueToUse -- null) ( 
setNull(ps, paramIndex, sqlTypeToUse, typeNameToUs 
e); 


j 


else ( 
setValue(ps, paramIndex, sqlTypeToUse, typeNameToU 
se, scale, inValueToUse); 


j 





8.3 query) fe HJ SEEN 














在 之 前 的 章节 中 我 们 介绍 了 update 方 法 的 功能 
实现 ， 那 么 在 数据 库 操作 中 查找 操作 也 是 使 用 率 非 
常 高 的 函数 ， 同 样 我 们 也 需要 了 解 它 的 实现 过 程 。 
使 用 方法 如 下 : 





List<User> list = jdbcTemplate.query("select * from user wher 
e age-?",new Object[] 


{20},new int[](java.sql.Types.INTEGER) ,new UserRowMapper( )); 





跟踪 jdbcTemplate 中 的 guery 方 法 。 





public «T» List<T> query(String sql, Object[] args, int[] argTy 
pes, RowMapper<T> 
rowMapper) throws DataAccessException { 

return query 


(sql, args, argTypes, new RowMapperResultSetExtractor<T> (rowMa 
pper)); 
} 


public «T» T query(String sql, Object[] args, int[] argTypes, R 
esultSetExtractor<T> rse) 
throws DataAccessException { 
return query 


(sql, newArgTypePreparedStatementSetter 


(args, argTypes), rse); 





上 面 函 数 中 与 update 方 法 中 都 同样 使 用 了 newArgTypePreparedStatement 
Setter 





public «T» T query(String sql, PreparedStatementSetter pss, Res 
ultSetExtractor<T> rse) throws DataAccessException { 
return query 


(new SimplePreparedStatementCreator(sql), pss, rse); 
} 
public «T» T query( 
PreparedStatementCreator psc, final PreparedStatem 
entSetter pss, final 
ResultSetExtractor<T> rse) 
throws DataAccessException { 


Assert.notNull(rse, "ResultSetExtractor must not be nu 
11"); 
logger.debug("Executing prepared SQL query"); 


return execute(psc, new PreparedStatementCallback«cT»() 
{ 
public T doInPreparedStatement(PreparedStatement p 
S) throws SQLException { 
ResultSet rs = null; 
try { 
if (pss != null) { 
pss.setValues(ps); 
} 


rs = ps.executeQuery(); 


ResultSet rsToUse - rs; 
if (nativeJdbcExtractor != null) { 
rsToUse - nativeJdbcExtractor.getNativ 
eResultSet(rs); 
} 


return rse.extractData(rsToUse); 


} 
finally { 
JdbcUtils.closeResultSet(rs); 
if (pss instanceof ParameterDisposer) ( 
((ParameterDisposer) pss).cleanupParam 
eters(); 
} 
} 


J): 


可 以 看 到 整体 套路 与 Update 差不多 的 ， 只 不 过 
在 回调 类 PreparedStatementCallback 的 实现 中 使 用 的 
是 ps.executeQuery0O 执 行 查 询 操作 ， 而 且 在 返回 方 
法 上 也 做 了 一 些 额外 的 处 理 。 


rse.extractData(rsToUse)77 1; fA vi 14 £à A ETT A 
装 并 转换 至 POJO，rse 当 前 代表 的 类 为 
RowMapperResultSetExtractor， 而 在 构造 
RowMapperResultSetExtractor 的 时 候 我 们 又 将 自 定 
义 的 rowMapper 设 置 了 进去 。 调 用 代码 如 下 : 








public List<T> extractData(ResultSet rs) throws SQLException { 
List<T> results = (this.rowsExpected > 0 ? new ArrayLi 
st<T>(this.rowsExpected) : new ArrayList<T>()); 
int rowNum = 0; 
while (rs.next()) 


results.add(this.rowMapper.mapRow(rs, rowNum++) ); 


j 


return results; 








上 面 的 代码 中 并 没有 什么 复杂 的 逻辑 ， 只 是 对 
返回 结果 允 历 并 以 此 使 用 rowMapper 进 行 转换 。 


之 前 讲 J 了 update 方法 以 及 query 方 法 ， 使 用 这 两 
个 函数 示例 的 SQL 都 是 带 有 参数 的 ， 也 融 是 带 有 ” 











? ”的 ， 那 么 还 有 为 一 种 情况 是 不 带 有 “?” 的 ， 





Spring 中 使 用 的 是 男 一 种 处 理 方式 。 例 如 : 


List<User> list = jdbcTemplate.query("select * from user", 
new UserRowMapper()); 





PR ERE A : 





public «T» List<T> query(String sql, RowMapper<T> rowMapper) th 
rows DataAccessException { 
return query 


(sql, new RowMapperResultSetExtractor<T>(rowMapper ) ); 


j 


public «T» T query(final String sql, final ResultSetExtractor<T 
> rse) throws DataAccessException { 
Assert.notNull(sql, "SQL must not be null"); 
Assert.notNull(rse, "ResultSetExtractor must not be nu 
11"); 
if (logger.isDebugEnabled()) { 
logger .debug("Executing SQL query [" + sql + "]"); 


} 
class QueryStatementCallback implements StatementCallb 
ack<T>, SqlProvider { 
public T doInStatement(Statement stmt) throws SQLE 
xception { 
ResultSet rs = null; 
try { 
rs = stmt.executeQuery(sql); 
ResultSet rsToUse = rs; 
if (nativeJdbcExtractor != null) { 
rsToUse = nativeJdbcExtractor.getNativ 
eResultSet(rs); 


} 

return rse.extractData(rsToUse); 
} 
finally { 


JdbcUtils.closeResultSet(rs); 


} 


is 
public String getSql() { 
return sql; 


j 
j 


return execute(new QueryStatementCallback 


0); 











与 之 前 的 query 方 法 最 大 的 不 同 是 少 了 参数 及 
参数 类 型 的 传递 ， 目 然 也 少 了 Prepared- 
StatementSetter 关 型 的 封装。 既然 少 了 
PreparedStatementSetter 类 型 的 传 入 ， 调 用 的 execute 


方法 目 然 也 会 有 所 改变 了 。 





public <T> T execute(StatementCallback<T> action) throws DataAc 
cessException { 
Assert.notNull(action, "Callback object must not be nu 


py 


Connection con - DataSourceUtils.getConnection(getData 
Source()); 
Statement stmt 
try { 
Connection conToUse = con; 
if (this.nativeJdbcExtractor != null && 
this.nativeJdbcExtractor.isNativeConnectio 
nNecessary ForNative 
Statements()) { 


null; 


conToUse = this.nativeJdbcExtractor.getNativeC 
onnection(con); 
} 
stmt = conToUse.createStatement(); 
applyStatementSettings(stmt); 
Statement stmtToUse - stmt; 
if (this.nativeJdbcExtractor !- null) ( 


stmtToUse - this.nativeJdbcExtractor.getNative 
Statement(stmt); 


T result = action.doInStatement(stmtToUse); 
handlewarnings(stmt); 
return result; 
} 
catch (SQLException ex) { 
// Release Connection early, to avoid potential co 
nnection pool deadlock 
// in the case when the exception translator hasn' 
t been initialized yet. 
JdbcUtils.closeStatement(stmt); 
stmt = null; 
DataSourceUtils.releaseConnection(con, getDataSour 
ce()); 
con - null; 
throw getExceptionTranslator().translate("Statemen 
tCallback", getSql(action), ex); 
} 


finally { 
JdbcUtils.closeStatement(stmt); 
DataSourceUtils.releaseConnection(con, getDataSour 


ce()); 








这 个 exexute 与 之 前 的 execute 并 无 太 大 差别 ， 都 





是 做 一 些 冲 规 的 处 理 ， 诸 如 获取 连接 、 释 连接 等 
但 是 ， 有 一 个 地 方 是 不 一 样 的 ， 残 是 statement 的 创 
建 。 这 里 直接 使 用 connection 创 建 ， 而 高 有 参数 的 
SQL 使 用 的 A PreparedStatementCreator 4 类 来 创建 
的 。 一 个 是 普通 的 Statement， 男 一 个 是 

MN ea 两 者 究竟 是 何 区 别 呢 ? 








PreparedStatement 接 口 继承 Statement， 并 与 之 


在 两 方面 有 所 不 同 。 


。PreparedStatement 实 例 包 含 已 编译 的 SQL 语句 。 
这 就 是 使 语句 “准备 好 ”。 包 合 
PreparedStatementX] £ rH SQL 语句 可 上 共有 一 个 
或 多 个 IN 参 数 。IN 参 数 的 值 在 SQL 语句 创建 时 
未 被 指定 。 相 反 的 ， 访 语句 为 每 个 IN 参数 保留 
一 个 问号 《"?") 作为 占 位 符 。 每 个 问号 的 值 必 
须 在 该 语句 执行 之 前 ， 通 过 适当 的 setXXX 方 法 
来 提供 。 

由 于 PreparedStatement 对 象 已 预 编译 过 ， 所 以 其 
执行 速度 要 快 于 Statement 对 象 。 因 此 ， 多 次 执 
行 的 SQL 语 句 经 常 创建 为 PreparedStatement 对 
象 ， 以 提高 效率 。 


作为 Statement 的 子 类 ，PreparedStatement 继 承 
J Statement Ar AWA. Fah, “ESI [HE 
方法 ， 用 于 设置 友 送 给 数据 库 以 取代 IN 参数 占 位 符 
的 值 。 同 时 ， 三 种 方法 execute、 executeQuery 和 
executeUpdate 已 被 更 改 以 使 之 不 再 需要 参数 。 这 些 
方法 的 Statement 形 式 《〈 接 受 SQL 语句 参数 的 形式 ) 
不 应 该 用 于 PreparedStatement 对 象 。 











8.4 queryForObject 


Spring 中 不 仅仅 为 我 们 提供 了 query 方 法 ， 还 在 
此 基础 上 做 了 封装 ， 提 供 了 不 同类 型 的 query 方 法 ， 
如 图 8-1 所 示 。 


a 


queryfor| 








4 KJ JdbcTemplate 
@ 4 queryForMap(String) : Map «String, Object» 
6 4 queryForObject(String, RowMapper<T=) «T» :T 
9 4 queryForObject(String, Class«T») «T» :T 
0 4 queryForLong(String) : long 
6 4 queryForInt(String) : int 
6 4 queryForList(String, Class«T») «T» : List<T» 
@ 4 queryForList(String) : Liste Map «String, Object» = 
0 4 queryForRowSet(String) : SqlRowSet 
9 4 queryForObject(String, Object[], int[], RowMapper«T») «T» :T 
6 4 queryForObject(string, Object[], RowMapper«T») «T» :T 
6 4 queryForObject(String, RowMappersT>, Object...) «T» :T 
6 4 queryForObject(String, Object[], int], Class <T>) «T= :T 
lea queryForObjectiString, Object[], Class«T») «T» :TI 
6.4 queryForObject(String, Class«T», Object.) <T> :T 
6 4 queryForMap(String, Object[], int[]) : Map «String, Object» 
© 4 queryForMap(String, Object...) : Map «String, Object» 





6 4 queryForLong(String, Object[], int[] : long 

9 4 queryForLong(String, Object...) : long 

6 4 queryForlnt(String, Object[], int[]) : int 

© 4 queryForlnt(String, Object...) : int 

6 4 queryForList(String, Object[], int[], Class <T>) «T» :Lists T» 
0 4 queryForList(String, Object[], Class<T=) «T» :list« T» 

6 4 queryForList(String, Class«T», Object...) «T» :List« T» 

@ 4 queryForList(String, Object[], int[]) : Lists Map «String, Object» > 
@ 4 queryForList(String, Object...) : Liste Map «String, Object» = 
6 4 queryForRowSet(String, Object[], int[]) : SalRowSet 

@ 4 queryForRowSet(String, Object...) : SalRowSet 


图 8-1 Spring 中 的 query 相 关 方 法 


我 们 以 queryForObject 为 例 ， 来 讨论 一 下 Spring 








ree Ur EI nz A] AER. ETT BER. 





public «T» T queryForObject(String sql, Class<T> requiredType) 
throws DataAccessException { 
return queryForObject 


(sql, getSingleColumnRowMapper 


(requiredType)); 
} 


public «T» T queryForObject(String sql, RowMapper«T» rowMapper ) 
throws DataAccessException { 
List<T> results = query(sql, rowMapper); 
return DataAccessUtils.requiredSingleResult(results); 








其 实 最 大 的 不 同 还 是 对 于 RowMapper 的 使 用 。 
SingleColumnRowMapper 类 中 的 mapRow: 





public T mapRow(ResultSet rs, int rowNum) throws SQLException { 
// 验 证 返回 结果 数 
ResultSetMetaData rsmd = rs.getMetaData(); 
int nrOfColumns - rsmd.getColumnCount(); 
if (nrOfColumns !- 1) ( 
throw new IncorrectResultSetColumnCountException(1 








, nrOfColumns); 


j 


// 抽 取 第 一 个 结果 进行 处 理 
Object result = getColumnValue(rs, 1, this.requiredTyp 


























e); 
if (result !- null && this.requiredType !- null && !th 
is.requiredType. 
isInstance(result)) ( 
// 转 换 到 对 应 的 类 型 


try { 
return (T) convertValueToRequiredType 


(result, this.requiredType); 


catch (IllegalArgumentException ex) { 
throw new TypeMismatchDataAccessException( 
"Type mismatch affecting row number " 
+ rowNum + " and 
column type '" + 
rsmd.getColumnTypeName(1) + "': " + ex 
.getMessage()); 
} 


} 


return (T) result; 





对 应 的 类 型 转换 函数 : 


protected Object convertValueToRequiredType(Object value, Class 
requiredType) ( 
if (String.class.equals(requiredType)) { 
return value.toString(); 





else if (Number.class.isAssignableFrom(requiredType)) 


if (value instanceof Number) { 
// Convert original Number to target Number cl 
ass. 





// 转 换 原 始 Number 类 型 的 实体 到 Number 类 

return NumberUtils.convertNumberToTargetClass( 
((Number) value), 
requiredType); 

yelse ( 

// 转 换 string 类 型 的 值 到 Number 类 

return NumberUtils.parseNumber(value.toString( 
), requiredType); 


j 


else ( 
throw new IllegalArgumentException( 
"Value [" + value + "] is of type [" + val 
ue.getClass().getName() + 


"] and cannot be converted to required typ 
e [" * requiredType. 
getName() + "]"); 


j 





39% #4MyBatis 





MyBatis 本 是 Apache 的 一 个 开源 项 目 iBatis， 
2010 年 这 个 项 目 由 Apache Software Foundation 迁移 
到 了 Google Code, Jf H.Z 73MyBatis. 





MyBatis 是 文 持 普通 SQL rif. Ef E ay 
Zi BUS A RAs FARNESE. MyBatis?H ER Y JLF 
有 的 JDBC 代 码 和 参数 的 手工 设置 以 及 结果 集 的 检 
索 。MyBatis 使 用 简单 的 XML 或 注解 用 于 配置 和 原 
始 映 射 ， 将 接口 和 Java 的 POJOS (Plain Old Java 
Objects， 普 通 的 Java 对 象 ) 映射 成 数据 库 中 的 记 
Ko 


9.1 MyBatis 独 立 使 用 


尽管 我 们 接触 更 多 的 是 MyBatis 与 Spring 的 整合 
使 用 ， 但 是 MyBatis 有 它 目 己 的 独立 使 用 方法 ， 了 
解 其 独立 使 用 的 方法 套路 对 分 析 Spring 整 合 MyBatis 
非常 有 帮助 ， 因 为 Spring 无 非 就 是 将 这 些 功能 进行 
封装 以 简化 我 们 的 开发 流程 。MyBatis 独 立 使 用 包 
括 以 下 几 步 。 





1. & v PO 


用 于 对 数据 库 中 数据 的 映射 ， 使 程序 员 更 关注 
于 对 Java 关 的 使 用 而 不 是 数据 库 的 操作 。 








public class User ( 
private Integer id; 
private String name; 
private Integer age; 
// 省 略 Set/get 方 法 





public User(String name, Integer age) { 
super(); 
this.name - name; 
this.age - age; 


public User() { 
super(); 
} // 必 须要 有 这 个 无 参 构造 方法 ， 不 然 根 据 UserMapper .xml 中 的 配置 ， 在 查 
询 数据 库 时 ， 将 不 能 反射 构造 
// 出 User 实 例 
} 


























2. Œ> Mapper 





AIE BEER TE AIP SCTE, EER E DUE 
DAO， 用 于 映射 数据 库 的 操作 ， 可 以 通过 配置 文件 
指定 方法 对 应 的 SQL 语句 或 者 直接 使 用 Java 提 供 的 
注解 方式 进行 SQL 指定 。 


public interface UserMapper { 
public void insertUser(User user); 





public User getUser(Integer id); 
} 


3. 建立 配置 文件 





配置 文件 主要 用 于 配置 程序 中 可 变性 高 的 设 
置 ， 一 个 偏 大 的 程序 一 定 会 存在 一 些 经 常会 变化 的 
变量 ， 如 果 每 次 变化 都 需要 改变 源码 那 会 是 非常 糟 
粹 的 设计 ， 所 以 ， 我 们 看 到 各 种 各 样 的 框架 或 者 应 
用 的 时 候 都 免不了 要 配置 配置 文件 ，MyBatis 中 的 
配置 文件 主要 封装 在 configuration 中 ， 配 置 文件 的 
基本 结构 如 图 9-1 所 示 。 

















图 9-1 配置 文件 结构 


。 configuration: 根 元 素 。 
e properties: 定义 配置 外 在 化 。 





settings: 一 些 全 局 性 的 配置 。 

typeAliases: 为 一 些 类 定义 别名 。 

typeHandlers: 定义 类 型 处 理 ， 也 就 是 定义 Java 
类 型 与 数据 库 中 的 数据 类 型 之 间 的 转换 关系 。 
objectFactory: 用 于 指定 结果 集 对 象 的 实例 是 如 
何 创建 的 。 

plugins: MyBatis 的 插件 ， 插 件 可 以 修改 MyBatis 
内 部 的 运行 规则 。 

environments: 环境 。 

environment: 配置 MyBatis 的 环境 。 
transactionManager: 事务 管理 器 。 

dataSource: 数据 源 。 
mappers: 指定 映射 文件 或 映射 类 。 


读者 如 果 对 上 面 的 各 个 配置 具体 使 用 方法 感 兴 
趣 ， 可 以 进一步 得 阅 相 关 资 料 ， 这 里 只 举 出 最 简单 
的 实例 以 方便 读者 快速 回顾 MyBatis。 




















<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 


<configuration> 

<settings> 
<!-- changes from the defaults for testing --> 
<setting name="cacheEnabled" value="false" /> 
«setting name="useGeneratedKeys" value="true" /> 
<setting name="defaultExecutorType" value="REUSE" /> 

</settings> 

<typeAliases> 
<typeAlias alias="User" type="bean.User"/> 


«/typeAliases» 
«environments default="development"> 
«environment id="development"> 
«transactionManager type="jdbc"/> 
«dataSource type="POOLED"> 
«property name="driver" value="com.mysql.jdbc.Dri 
ver" /> 
«property name="url" value="jdbc:mysql://localhos 
t/lexueba"/» 
«property name="username" value="root"/> 
«property name="password" value="haoj1a0421x1ixi"/ 


</dataSource> 
</environment> 
</environments> 


<mappers> 
«mapper resource="resource/UserMapper.xml" /> 
</mappers> 
</configuration> 





4. 建立 映射 文件 


对 应 于 MyBaits 全 局 配置 中 的 mappers 配 置 属 
性 ， 主 要 用 于 建立 对 应 数据 库 操作 接口 的 SQL 映 
味 。MyBatis 会 将 这 里 设 定 的 SQL 与 对 应 的 Java 接 口 
相关 联 ， 以 保证 在 MyBatis 中 调用 接口 的 时 候 会 到 
数据 库 中 执行 相应 的 SQL 来 简化 开发 。 


<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
«mapper namespace="Mapper .UserMapper'"> 
<!-- 这 里 namespace 必 须 是 UserMapper 接 口 的 路 径 ， 不 然 要 运行 的 时 候 要 报错 “i 
s not known to the MapperRegistry” --> 
«insert id-"insertUser" parameterType="User" > 











insert into user(name,age) values(#{name}, #{age}) 
«1-- 这 里 sq1 结 尾 不 能 加 分 号 ， 和 否则 报 “ORA-00911” 的 错误 --> 
</insert> 








«1-- 这 里 的 id 必须 和 UserMapper 接 口中 的 接口 方法 名 相同 ， 不 然 运行 的 时 候 
也 要 报错 --> 


«select id-"getUser" resultType="User" parameterType="java. 
lang.Integer" » 


select * from user where id=#{id} 
</select> 
</mapper> 








5. 建立 测试 类 


至 此 我 们 已 经 完成 了 MyBatis 的 建立 过 程 ， 接 
下 来 的 工作 束 古 对 之 前 的 所 有 工作 进行 测试 ， 以 便 
直接 人 看 MyBatis 为 我 们 提供 的 效果 。 





public class MyBatisUtil { 
private final static SqlSessionFactory sqlSessionFactory; 


static ( 
String resource - "resource/mybatis-config.xml"; 
Reader reader - null; 
try { 


reader = Resources.getResourceAsReader(resource); 
) catch (IOException e) ( 


System.out.println(e.getMessage()); 
} 


sqlSessionFactory = new SqlSessionFactoryBuilder().build 
(reader); 


public static SqlSessionFactory getSqlSessionFactory() { 
return sqlSessionFactory; 
} 


public class TestMapper { 


static SqlSessionFactory sqlSessionFactory - null; 
static { 

sglSessionFactory = MyBatisUtil.getSqlSessionFactory(); 
} 


@Test 
public void testAdd() { 
SqlSession sqlSession - sqlSessionFactory.openSession(); 


try { 
UserMapper userMapper - sqlSession.getMapper(UserMap 
per.class); 
User user - new User("tom",new Integer(5)); 
userMapper.insertUser(user); 
sqlSession.commit();// 这 里 一 定 要 提交 ， 不 然 数 据 进 不 去 数据 库 











中 
) finally ( 
sglSession.close(); 
} 
} 
QTest 


public void getUser() ( 
SqlSession sqlSession - sqlSessionFactory.openSession(); 


try { 
UserMapper userMapper = sqlSession.getMapper(UserMap 
per.class); 
User user - userMapper.getUser(1); 
System.out.println("name: "+user.getName()+"|age: "+ 
user.getAge()); 
) finally { 
sglSession.close(); 





注意 ， 这 里 在 数据 库 设 定 了 id 目 增 集 略 ， 所 以 
插入 的 数据 会 直接 在 数据 库 中 赋值 ， 当 执行 测试 后 
如 果 数 据 表 为 空 ， 那 么 在 表 中 会 出 现 一 条 我 们 插入 


的 数据 ， 并 会 在 查询 时 将 此 数据 查 出 。 
9.2 Spring * ^; MyBatis 


了 解 了 MyBatis 的 独立 使 用 过 程 后 ， 我 们 再 看 
看 它 与 Spring 整合 的 使 用 方式 ， 比 对 之 前 的 示例 来 
找 出 Spring 完 竟 为 我 们 做 了 哪些 操作 来 徐 化 程序 员 
的 业务 开发 。 由 于 在 上 和 面 示例 基础 上 作 更 改 ， 所 
以 ，User 与 UserMapper 保 持 不 变 。 





1. Spring 配置 文件 


配置 文件 是 Spring 的 核心 ，Spring 的 所 有 操作 
也 都 是 由 配置 文件 开始 的 ， 所 以 ， 我 们 的 示例 也 首 
先 从 配置 文件 开始 。 





<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.Springframework.org/schema/b 

eans http://www.Springframework. org/ schema/beans/Spring-beans 

-3.0.xsd"» 


«bean id="dataSource" class="org.apache.commons.dbcp.BasicD 

ataSource"> 

«property name="driverClassName" value-"com.mysql.jdbc. 
Driver"></property> 

«property name="url" value="jdbc:mysql://localhost : 3306 
/lexueba?useUnicode- 
true&amp; characterEncoding-UTF-8&amp;zeroDateTimeBehavior-conve 
rtToNull"></property> 


«property name-"username" value="root"></property> 
«property name="password" value-z"haojia0421xixi"»«/prop 


erty> 
<property name="maxActive" value="100"></property> 
«property name="maxIdle" value="30"></property> 
<property name="maxWait" value="500"></property> 
<property name="defaultAutoCommit" value="true"></prope 
rty> 
</bean> 


«bean id="sqlSessionFactory" class="org.mybatis.Spring.SqlS 
essionFactoryBean"> 
«property name="configLocation" value="classpath:test/m 
ybatis/MyBatis-Configuration. xml"></property> 
<property name="dataSource" ref="dataSource" /> 
</bean> 


«bean id="userMapper" class="org.mybatis.Spring.mapper .Mapp 
erFactoryBean"> 
«property name-"mapperInterface" value="test.mybatis.da 
o.UserMapper"></property> 


«property name="sqlSessionFactory" ref="sqlSessionFacto 
ry"></property> 
</bean> 


</beans> 








对 比 之 前 独立 使 用 MyBatis 的 配置 文件 ， 我 们 
发 现 ， 之 前 在 environments 中 设置 的 dataSource 被 转 
移 到 了 Spring 的 核心 配置 文件 中 管理 。 而 且 ， 针 对 
于 MyBatis， 注 册 了 
org.mybatis. Spring.SqlSessionFactoryBean2< 4! 
bean， 以 及 用 于 映射 接口 的 org.mybatis.Spring. 
mapper.MapperFactoryBean， 这 两 个 bean 的 作用 我 


们 会 在 稍 后 分 析 。 


之 前 我 们 了 解 到 ，MYyBatis 提 供 的 配置 文件 包 
含 了 诸多 属性 ， 虽 然 大 多 数 情 况 我 们 都 会 保持 
MyBatis 原 有 的 风格 ， 将 MyBatis 的 配置 文件 独立 出 
来 ， 并 在 Spring 中 的 org.mybatis.Spring. 
SqlSessionFactoryBean 类 型 的 bean 中 通过 
configLocation 属 性 引入 ， 但 是 ， 这 并 不 代表 Spring 
不 文 持 直 接 配 置 。 以 上 面 示例 为 例 ， 你 完全 可 以 省 
去 MyBatis-Configuration.xml， 而 将 其 中 的 配置 以 属 
性 的 方式 注入 到 SqlSessionFactoryBean 中 ， 至 于 每 
个 属性 名 称 以 及 用 法 ， 我 们 会 在 后 面 的 章节 中 进行 
详细 的 分 析 。 








2. MyBatis 配 置 文件 


对 比 独 立 使 用 MyBatis 时 的 配置 文件 ， 当 前 的 
配置 文件 除了 移 除 environments 配 置 外 并 没有 大 多 
的 变化 。 





<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0/ 
/EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<typeAliases> 
«typeAlias alias="User" type="test.mybatis.bean.User"/> 
</typeAliases> 
<mappers> 
«mapper resource="test/mybatis/UserMapper.xml"/> 


«/mappers? 
«/configuration» 
3. 映射 文件 (保持 不 变 ) 


«?xml version="1.0" encoding="UTF-8" ?> 
«!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "h 
ttp://mybatis.org/ dtd/mybatis-3-mapper.dtd"> 
«mapper namespace="test.mybatis.dao.UserMapper"> 
«insert id-"insertUser" parameterType="User" > 
insert into user(name,age) values(Z(name),z1(age)) 
</insert> 


«select id-"getUser" resultType="User" parameterType="java. 
lang.String" > 
select * from user where name=#{name} 
</select> 
</mapper> 





4. 测试 


人 至此， 我 们 已 经 完成 了 Spring 与 MyBatis 的 整 
合 ， 我 们 发 现 ， 对 于 MyBatis 方 面 的 配置 文件 ， 除 
了 将 dataSource 配 置 移 到 Spring 配置 文件 中 管理 外 ， 
并 没有 太 多 变化 ， 而 在 Spring 的 配置 文件 中 又 增加 
了 用 于 处 理 MyBatis 的 两 个 bean。 


Spring 整合 MyBatis 的 优势 主要 在 于 使 用 上 ， 我 
们 来 看 看 Spring 中 使 用 MyBatis 的 用 法 。 


public class UserServiceTest ( 
public static void main(String[] args) { 
ApplicationContext context - new ClassPathXmlApplicati 
onContext("test/ mybatis/ 
applicationContext.xml"); 


UserMapper userDao = (UserMapper )context.getBean("userM 


apper"); 
System.out.println(userDao.getUser("1")); 


j 





测试 中 我 们 看 到 ， 在 Spring 中 使 用 MyBatis 非 党 
方便 ， 用 户 甚至 无 法 察 和 党 目 己 正在 使 用 MyBatis， 
而 这 一 切 相 对 于 独立 使 用 MyBatis 时 必须 要 做 的 各 
种 见 余 操作 来 说 无 非 是 大 大 简化 了 我 们 的 工作 量 。 


9.3 ”源码 分 析 


通过 Spring 整合 MyBatis 的 示例 ， 我 们 感受 到 了 
Spring 为 用 户 更 加 快捷 地 进行 开发 所 做 的 努力 ， 开 
发 人 员 的 工作 效率 由 此 得 到 了 显著 的 提升 。 但 是 ， 
相对 于 使 用 来 说 ， 我 们 更 想 知 道 其 背后 所 隐藏 的 秘 
窗 ，Spring 整 合 MyBatis 是 何如 实现 的 呢 ? 通 过 分 析 
整合 示例 中 的 配置 文件 ， 我 们 可 以 知道 配置 的 bean 
其 实 是 成 树 状 结 构 的 ， 而 在 树 的 最 项 层 是 类 型 为 
org.mybatis. Spring.SqlSessionFactoryBeanfJbean, 
它 将 其 他 相关 bean 组 装 在 了 一 起 ， 那 么 ， 我 们 的 分 
析 束 从 此 类 开始 。 








9.3.1  sqlSessionFactory | Æ 


通过 配置 文件 我 们 分 机 ， 对 于 配置 文件 的 读 取 
解 机 ，Spring 应 该 通过 org.mybatis.Spring. 
SqlSessionFactoryBean 封 装 了 MYyBatis 中 的 实现 。 我 
们 进入 这 个 类 ， 首 先 碍 看 这 个 类 的 层次 结构 ， 如 图 
9-2 所 示 。 





«n E 
4 K9 SqlSessionFactoryB ean 
Q Object 
4 © ApplicationListener<E> 
@ EventListener 
Q FactoryBean<T= 
o 


InitializingB ean 





图 9-2 ”SqlSessionFactoryBean 类 的 层次 结构 图 


根据 这 个 类 的 层次 结构 找 出 我 们 感 兴趣 的 两 个 
接口 ，FactoryBean 和 JInitializingBean。 








e InitializingBean: 实现 此 接口 的 bean 会 在 初始 化 
时 调用 其 afterPropertiesSet 方 法 来 进行 bean 的 人 逻 
辑 初 始 化 。 

e FactoryBean: 一 旦 某 个 bean 实 现 次 接口 ， 那 么 
通过 getBean 方 法 获取 bean 时 其 实 是 获取 此 类 的 
getObject() 返 回 的 实例 。 


我 们 首先 以 PnitializingBean 接 口 的 
afterPropertiesSet() 方 法 作为 突破 点 。 


1. SqlSessionFactoryBean 的 初始 化 


查看 org.mybatis.Spring.SqlSessionFactoryBean 
类 型 的 bean 在 初始 化 时 做 了 哪些 逻辑 实现 。 


public void afterPropertiesSet() throws Exception { 
notNull(dataSource, "Property 'dataSource' is required"); 
notNull(sqlSessionFactoryBuilder, "Property 'sqlSessionFact 
oryBuilder' is required"); 


this.sqlSessionFactory = buildSqlSessionFactory 


(); 
} 





AR SERA. ERZE EN S T 
sqlSessionFactory 的 初始 化 ， 通 过 之 前 展示 的 独立 使 
用 MyBatis 的 示例 ， 我 们 了 解 到 SqlSessionFactory 坪 
所 有 MyBatis 功 能 的 基础 。 





protected SqlSessionFactory buildSqlSessionFactory() throws IO 
Exception { 


Configuration configuration; 


XMLConfigBuilder xmlConfigBuilder - null; 
if (this.configLocation 


I= null) { 


xmlConfigBuilder - new XMLConfigBuilder(this.configLocati 
on.getInputStream(), 
null, this.configurationProperties); 

configuration - xmlConfigBuilder.getConfiguration(); 

) else ( 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Property 'configLocation' not specif 

ied, using default 
MyBatis Configuration"); 


configuration - new Configuration(); 
configuration.setVariables(this.configurationProperties); 


J 


if (this.objectFactory 


I- null) ( 
configuration.setObjectFactory(this.objectFactory); 


j 


if (this.objectWrapperFactory 


I= null) ( 
configuration.setObjectWrapperFactory(this.objectWrapperF 
actory); 


if (hasLength(this.typeAliasesPackage 


))t 
String[] typeAliasPackageArray - tokenizeToStringArray(th 


is.typeAliasesPackage, 
ConfigurableApplicationContext.CONFIG LOCATION DELIMI 
TERS); 
for (String packageToScan : typeAliasPackageArray) { 
configuration.getTypeAliasRegistry().registerAliases(pa 
ckageToScan, 
typeAliasesSuperType == null ? Object.class : t 
ypeAliasesSuperType); 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Scanned package: '" + packageToSca 
n+ "' for aliases"); 
} 
} 
} 


if (!isEmpty(this.typeAliases 


)) { 
for (Class<?> typeAlias : this.typeAliases) { 
configuration.getTypeAliasRegistry().registerAlias(type 
Alias); 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Registered type alias: '" + typeAl 
ias + "TUS 
} 
} 


if (!isEmpty(this.plugins) 


Jot 
for (Interceptor plugin : this.plugins) ( 
configuration.addInterceptor(plugin); 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Registered plugin: '" + plugin + " 


if (hasLength(this.typeHandlersPackage 


)) { 
String[] typeHandlersPackageArray = tokenizeToStringArray 
(this.typeHandlersPackage, 
ConfigurableApplicationContext.CONFIG LOCATION DELIMI 
TERS); 
for (String packageToScan : typeHandlersPackageArray) { 
configuration.getTypeHandlerRegistry().register(package 
ToScan); 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Scanned package: '" + packageToSca 
n+ "' for type handlers"); 
} 
} 
} 


if (!isEmpty(this.typeHandlers 


)) 4 
for (TypeHandler<?> typeHandler : this.typeHandlers) { 


configuration.getTypeHandlerRegistry().register(typeHan 
dler); 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Registered type handler: '" + type 
Handler + "'"); 
} 
} 
} 


if (xmlConfigBuilder !- null) { 


try { 
xmlConfigBuilder.parse(); 


if (this.logger.isDebugEnabled()) { 
this.logger.debug("Parsed configuration file: '" + th 
is.configLocation + "'"); 
} 
} catch (Exception ex) { 
throw new NestedlIOException("Failed to parse config res 


ource: " + this. configLocation, ex); 
) finally ( 
ErrorContext.instance().reset(); 
} 
} 
if (this.transactionFactory == null 
) { 


this.transactionFactory = new SpringManagedTransactionFac 
tory(); 
} 


Environment environment = new Environment(this.environment, 
this.transactionFactory, this.dataSource); 
configuration.setEnvironment(environment); 


if (this.databaseldProvider !- null 


) 1 


try { 
configuration.setDatabaseld(this.databaseIdProvider.get 


Databaseld (this.dataSource)); 
) catch (SQLException e) ( 


throw new NestedIOException("Failed getting a databaseI 
d", e); 
} 


j 


if (!isEmpty(this.mapperLocations 


))t 
for (Resource mapperLocation : this.mapperLocations) { 
if (mapperLocation == null) { 
continue; 
} 
try { 
XMLMapperBuilder xmlMapperBuilder = new XMLMapperBuil 
der(mapperLocation. 


getInputStream(), 
configuration, mapperLocation.toString(), configu 
ration.getSqlFragments()); 
xmlMapperBuilder.parse(); 
) catch (Exception e) ( 
throw new NestedIOException("Failed to parse mapping 
resource: '" + 


mapperLocation + "'", e); 
) finally ( 
ErrorContext.instance().reset(); 
} 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Parsed mapper file: '" + mapperLoc 
ation + "'"); 
} 
} 
} else { 


if (this.logger.isDebugEnabled()) { 
this.logger.debug("Property 'mapperLocations' was not s 
pecified or no matching resources found"); 
} 
} 


return this.sglSessionFactoryBuilder.build(configuration); 





Peg rp a] A SU, KERNE ENTA 
MyBatis 的 配置 与 Spring 的 配置 独立 出 来 ， 但 是 ， 这 
并 不 代表 Spring 中 的 配置 不 文 持 直接 配置 。 也 就 是 
说 ， 在 上 面 提供 的 示例 中 ， 你 完全 可 以 取消 配置 中 
的 configLocation 属 性 ， 而 把 其 中 的 属性 直接 写 在 
SqlSessionFactoryBean 中 。 








«bean id="sqlSessionFactory" class="org.mybatis.Spring.SqlSessi 
onFactoryBean"> 

«property name="configLocation" value="classpath:test/m 
ybatis/MyBatis- Configuration. xml"></property> 


«property name="dataSource" ref="dataSource" /» 
«property name="typeAliasesPackage" value="aaaaa"/> 





从 这 个 函数 中 可 以 得 知 ， 配 置 文件 还 可 以 文 持 
其 他 多 种 属性 的 配置 ， 如 configLocation、 
objectFactory、 objectWrapperFactory、 
typeAliasesPackage、typeAliases、 
typeHandlersPackage、plugins、typeHandlers、 
transactionFactory、 databaseldProvider、 
mapperLocations. 


Ask, INRA RAMA, BARR A 
要 在 函数 最 开始 按照 如 下 方式 处 理 configuration: 


xmlConfigBuilder - new XMLConfigBuilder(this.configLocation.get 
InputStream(), null, 


this.configurationProperties); 
configuration - xmlConfigBuilder.getConfiguration(); 





T $i configLocationt4 ia XMLConfigBuilderJf-3t 
行 解 机 ， 但 是 ， 为 了 体现 Spring 更 强大 的 兼容 性 ， 
Spring 还 整合 了 MyBatis 中 其 他 属性 的 注入 ， 并 通过 
实例 configuration 来 承载 每 一 步 所 获取 的 信息 并 最 
终 使 用 sqlSessionFactoryBuilder 实 例 根据 解析 到 的 
configuration 创 建 SqlSessionFactory 实 例 。 


2. 获取 SqlSessionFactoryBean 实 例 


由 于 SqlSessionFactoryBean 实 现 了 FactoryBean 
接口 ， 所 以 当 通 过 getBean 方 法 获取 对 应 实例 时 ， 其 
实 是 获取 该 类 的 getObject0) 函 数 返 回 的 实例 ， 也 就 
是 获取 初始 化 后 的 sqlSession Factory 属 性 。 





public SqlSessionFactory getObject() throws Exception { 
if (this.sqlSessionFactory == null) { 
afterPropertiesSet(); 


j 


return this.sglSessionFactory; 





9.3.2 ”MapperFactoryBean 的 创建 


为 了 使 用 MyBatis 功 能 ， 示 例 中 的 Spring 配置 文 
件 提 供 了 两 个 bean， 除 了 之 前 分 析 的 
SqlSssionFactoryBean 类 型 的 bean 以 外 ， 还 有 一 个 是 
MapperFactoryBean 类 型 的 bean。 


结合 两 个 测试 用 例 综合 分 析 ， 对 于 单独 使 用 
MyBatis 的 时 候 调 用 数据 库 接 口 的 方式 是 : 


UserMapper userMapper = sqlSession.getMapper(UserMapper.class); 


而 在 这 一 过 程 中 ， 其 实 是 MyBatis 在 获取 映射 
的 过 程 中 根据 配置 信息 为 UserMapper 类 型 动态 创建 
了 代理 类 。 而 对 于 Spring 的 创建 方式 : 


UserMapper userMapper = (UserMapper )context.getBean("userMapper 
2); 


Spring 中 获取 的 名 为 userMapper 的 bean， 其 实 
是 与 单独 使 用 MyBatis 完 成 了 一 样 的 功能 ， 那 么 我 
们 可 以 推 闻 ， 在 bean 的 创建 过 程 中 一 定 是 使 用 了 
MyBatis 中 的 原生 方法 
sqlSession.getMapper(UserMapper.class)3tí] Jf BHj— 
KER. FAME PE, RAHENA HERF 
org.mybatis.Spring.mapper. MapperFactoryBean, 4JJ 
步 推测 其 中 的 馆 辑 应 该 在 此 类 中 实现 。 同 样 ， 还 是 
首先 查看 的 类 层次 结构 图 MapperFactoryBean， 如 图 
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图 9-3 ”MapperFactoryBean 类 的 层次 结构 图 


同样 ， 在 实现 的 接口 中 发 现 了 我 们 感 兴趣 的 两 
个 接口 InitializingBean 与 FactoryBean。 我 们 的 分 析 
还 是 从 bean 的 初始 化 开始 。 


1. MapperFactoryBean 的 初始 化 


为 实现 了 InitializingBean 接 口 ，Spring 会 保证 
在 bean 初 始 化 时 首先 调用 afterPropertiesSet 方 法 来 完 
MAUR IF. BEERS, AXWafterPropertiesSet 
方法 是 在 DaoSupport 类 中 实现 ， 代 码 如 下 : 











public final void afterPropertiesSet() throws IllegalArgumentEx 
ception, BeanInitialization 
Exception { 
// Let abstract subclasses check their configuration. 
checkDaoConfig 


// Let concrete implementations initialize themselves. 


try { 
initDao 


} 
catch (Exception ex) { 
throw new BeanInitializationException("Initializat 
ion of DAO failed", ex); 
} 
} 





但 从 函数 名 称 来 看 我 们 大 体 推 测 ， 
MapperFactoryBean 的 初始 化 包括 对 DAO 配 置 的 验 
证 以 及 对 DAO 的 初始 工作 ， 其 中 initDao0) 方 法 是 模 
板 方 法 ， 设 计 为 留 给 子 类 做 进一步 逻辑 处 理 。 而 
checkDaoConfig() 才 是 我 们 分 析 的 重点 。 





@Override 
protected void checkDaoConfig() { 
super .checkDaoConfig(); 


notNull(this.mapperInterface, "Property 'mapperInterface' i 
s required"); 


Configuration configuration - getSqlSession().getConfigurat 
ion(); 
if (this.addToConfig && !configuration.hasMapper(this.mappe 
rInterface)) { 
try { 
configuration.addMapper(this.mapperInterface); 
) catch (Throwable t) ( 
logger.error("Error while adding the mapper '" + this.m 
apperInterface + "' to configuration.", t); 
throw new IllegalArgumentException(t); 
) finally ( 


ErrorContext.instance().reset(); 





super.checkDaoConfig() E SqlSessionDaoSupport 


protected void checkDaoConfig() { 
notNull(this.sqlSession, "Property 'sqlSessionFactory' or ' 
sqlSessionTemplate' are required"); 





结合 代码 我 们 了 解 到 对 于 DAO 配 置 的 验证 ， 
Spring 做 了 以 下 几 个 方面 的 工作 。 


。 父 类 中 对 于 sqlSession 不 为 空 的 验证 。 


sqlSession 作 为 根据 接口 创建 映射 器 代理 的 接触 
类 一 定 不 可 以 为 室 ， 而 sqlSession 的 初始 化 工作 是 在 
设 定 其 sqlSessionFactory 属 性 时 完成 的 。 





public void setSqlSessionFactory(SqlSessionFactory sqlSessionF 
actory) { 
if (!this.externalSqlSession) { 
this.sqlSession - new SqlSessionTemplate(sqlSessionFactor 





也 残 是 说 ， 对 于 下 面 的 配置 如 果 包 略 了 对 于 
sqlSessionFactory 属 性 的 设置 ， 那 么 在 此 时 就 会 被 检 
in moa. 


«bean id="userMapper" class="org.mybatis.Spring.mapper .MapperF 
actoryBean"> 

«property name-"mapperInterface" value="test.mybatis.da 
o.UserMapper"></property> 

<property name-"sqlSessionFactory 





" ref="sqlSessionFactory"></property> 
</bean> 





e HEITE O YATE.» 


接口 是 映射 器 的 基础 ，sqlSession 会 根据 接口 动 
态 创 建 相应 的 代理 类 ， 所 以 接口 必 不 可 少 。 


。 了 映射 文件 存在 性 验证 。 


对 于 函数 前 半 部 分 的 验证 我 们 都 很 容易 理解 ， 

无 非 是 对 配置 文件 中 的 属性 是 否 存 在 做 验证 ， 但 是 
后 面部 分 是 完成 了 什么 方面 的 验证 呢 ? 如果 读者 读 
过 MyBatis 源 码 ， 你 就 会 知道 ， 在 MyBatis 实 现 过 程 
中 并 没有 手动 调用 configuration.addMapper 方 法 ， 而 
是 在 映射 文件 恋 取 过 程 中 一 旦 解析 到 如 <mapper 
namespace="Mapper.UserMapper">， 便 会 目 动 进行 
类 型 映射 的 注册 。 那 么 ，Spring 中 为 什么 会 把 这 个 








功能 单独 拿 出 来 放 在 验证 里 呢 ? 这 是 不 是 多 此 一 举 
NE? 


fe EIR AY eA 

configuration.addMapper(this.mapperInterface) E; S iit 
是 将 UserMapper 注 册 到 映射 类 型 中 ， 如 果 你 可 以 保 
证 这 个 接口 一 定 存在 对 应 的 映射 文件 ， 那 么 其 实 这 
个 验证 并 没有 必要 。 但 是 ， 由 于 这 个 是 我 们 目 行 决 
定 的 配置 ， 无 法 保证 这 里 配置 的 接口 一 定 存 在 对 应 
的 映射 文件 ， 所 以 这 里 非常 有 必要 进行 验证 。 在 执 
行 此 代码 的 时 候 ，MyBatis 会 检查 肉 入 的 映射 接口 
和 是否 存 在 对 应 的 映射 文件 ， 如 宁 没 有 回 抛 出 弄 帝 ， 
Spring 正 是 在 用 这 种 方式 来 完成 接口 对 应 的 映射 文 
件 存 在 性 验证 。 

















2. 获取 MapperFactoryBean 的 实例 
由 于 MapperFactoryBean 实 现 了 FactoryBean 接 


口 ， 所 以 当 通 过 getBean 方 法 获取 对 应 实例 的 时 候 其 
实 是 获取 该 类 的 getObject0 函 数 返回 的 实例 。 


public T getObject() throws Exception ( 
return getSqlSession().getMapper(this.mapperInterface); 
} 


这 段 代 码 正 是 我 们 在 提供 MyBatis 独 立 使 用 的 








时 候 的 一 个 代码 调用 。Spring 通 过 FactoryBean 进 行 
THR. 


9.3.3 MapperScannerConfigurer 


我 们 在 applicationContext.xml 中 配置 了 
userMapper 供 需要 时 使 用 。 但 如 果 需 要 用 到 的 映射 
器 较 多 的 话 ， 采 用 这 种 配置 方式 束 显 得 很 低 效 。 为 
了 解决 这 个 问题 ， 我 们 可 以 使 用 MapperScanner 
Configurer， 让 它 扫 描 特 定 的 包 ， 目 动 帮 我 们 成 批 
地 创建 映射 右 。 这 样 一 来 ， 束 能 大 大 减少 配置 的 工 
作 量 ， 比 如 我 们 将 applicationContext.xml 文 件 中 的 
配置 改 成 如 下 : 














<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://www.Springframework.org/schema/b 

eans http://www.Springframework. 

org/schema/beans/Spring-beans-3.0.xsd"> 


<bean id="dataSource" class="org.apache.commons.dbcp.BasicD 

ataSource"> 

«property name="driverClassName" value-"com.mysql.jdbc. 
Driver"></property> 

«property name="url" value="jdbc:mysql://localhost : 3306 
/ lexueba?useUnicode- 
true&amp; characterEncoding-UTF-8&amp;zeroDateTimeBehavior-conve 
rtToNull"></property> 

<property name="username" value="root"></property> 

«property name="password" value="haoj1a0421x1ix1i"></prop 
erty> 

<property name="maxActive" value="100"></property> 


«property name="maxIdle" value="30"></property> 
<property name="maxWait" value="500"></property> 
<property name="defaultAutoCommit" value="true"></prope 
rty> 
</bean> 


«bean id="sqlSessionFactory" class-'org.mybatis.Spring.SqlS 
essionFactoryBean"> 
<property name="configLocation" value="classpath:test/m 
ybatis/MyBatis- Configuration. 
xml"2«/property» 
«property name="dataSource" ref="dataSource" /» 
«property name="typeAliasesPackage" value="aaaaa"/> 
</bean> 











«1-- 注释 掉 原 有 代码 
«bean id="userMapper" class="org.mybatis.Spring.mapper .Mapp 
erFactoryBean"> 
«property name-"mapperInterface" value="test.mybatis.da 
o.UserMapper"></property> 
<property name="sqlSessionFactory" ref="sqlSessionFacto 
ry"></property> 
</bean> 
--> 








<bean class="org.mybatis.Spring.mapper .MapperScannerConfigure 
r"> 

<property name="basePackage" value="test.mybatis.dao" /> 

</bean> 


</beans> 
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CuserMapper 的 创建 ) 而 增加 了 MapperScanner 
Configurer 的 配置 ，basePackage 属 性 是 让 你 为 映射 
璐 接口 文件 设置 基本 的 包 路 径 。 你 可 以 使 用 分 号 或 
喜 写 作为 分 隔 符 设 置 多 于 一 个 的 包 路 径 。 每 个 映射 
项 将 会 在 指定 的 包 路 径 中 递归 地 被 搜索 到 。 被 发 现 





的 映射 器 将 会 使 用 Spring 对 自动 侦 测 组 件 默 认 的 命 
ARM Ki A. Hate, WRIA RUE, C 
WLS f FH RU AS SEK S SESE AIR ERA. [HIE 
n AI, T @Component=KISR-330@Namedy+ fë., 

它 会 获取 名 称 。 


通过 上 面 的 配置 ，Spring 就 会 帮助 我 们 对 test. 
mybatis.dao 下 面 的 所 有 接口 进行 自动 的 注入 ， 而 不 
需要 为 每 个 接口 重复 在 Spring 配置 文件 中 进行 声明 
了 。 那 么 ， 这 个 功能 又 是 如 何 做 到 的 呢 ? 
MapperScanner Configurer 中 又 有 哪些 核心 操作 呢 ? 
同样 ， 首 先 查 看 类 的 层次 结构 图 ， 如 图 9-4 所 示 。 


[En E - 
4 K9 MapperScannerConfigurer 
© Object 
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Q  Aware 











BeanDefinitionRegistryPostProcessor 
@ BeanFactoryPostProcessor 
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InitializingB ean 
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图 9-4 ”MapperScannerConfigurer 类 的 层次 结构 图 


我 们 又 看 到 了 令 人 感 兴趣 的 接口 
InitializingBean， 马 上 得 找 关 的 afterPropertiesSet 方 
法 来 看 看 类 的 初始 化 逻辑 。 











public void afterPropertiesSet() throws Exception { 
notNull(this.basePackage, "Property 'basePackage' is requir 
ed"); 


j 





很 遗憾 ， 分 析 并 没有 想 我 们 之 前 那样 顺利 ， 
afterPropertiesSet() 方 法 除了 一 句 对 basePackage 属 性 
的 验证 代码 外 并 没有 太 多 的 逻辑 实现 。 好 吧 ， 让 我 
们 回 过 头 再 次 查看 MapperScanner Configurer 类 层次 
结构 图 中 感 兴趣 的 接口 。 于 是 ， 我 们 发 现 了 
BeanDefinitionRegistryPostProcessor 与 
BeanFactoryPostProcessor，Spring 在 初始 化 的 过 程 
中 同样 会 保证 这 两 个 接口 的 调用 。 


首先 但 看 MapperScannerConfigurer 类 中 对 于 
BeanFactoryPostProcessor 接 口 的 实现 : 








public void postProcessBeanFactory(ConfigurableListableBeanFact 
ory beanFactory) { 
// left intentionally blank 


j 





没有 任何 逻辑 实现 ， 只 能 说 明 我 们 找 错 地 方 
了 ， 继 续 找 ， 查 看 MapperScannerConfigurer 类 中 对 
于 BeanDefinitionRegistryPostProcessor 接 口 的 实现 。 





public void postProcessBeanDefinitionRegistry(BeanDefinitionReg 
istry registry) throws BeansException ( 
if (this.processPropertyPlaceHolders) { 


processPropertyPlaceHolders 


ClassPathMapperScanner scanner - new ClassPathMapperScanner 
(registry); 
scanner.setAddToConfig(this.addToConfig); 
scanner.setAnnotationClass(this.annotationClass); 
scanner.setMarkerInterface(this.markerInterface); 
scanner.setSqlSessionFactory(this.sqlSessionFactory); 
scanner.setSqlSessionTemplate(this.sqlSessionTemplate); 
scanner.setSqlSessionFactoryBeanName(this.sqlSessionFactory 
BeanName); 
scanner.setSqlSessionTemplateBeanName(this.sqlSessionTempla 
teBeanName); 
scanner.setResourceLoader(this.applicationContext); 
scanner.setBeanNameGenerator(this.nameGenerator); 
scanner.registerFilters 


(0; 


scanner.scan 


(StringUtils.tokenizeToStringArray(this.basePackage, Configurab 
le ApplicationContext.CONFIG LOCATION DELIMITERS)); 





Bingo! 这 次 找 对 地 方 了 。 大 致 看 一 下 代码 实 
现 ， 正 是 完成 了 对 指定 路 径 扫 朱 的 馆 辑 。 那 么 ， 我 
们 就 以 此 为 入 口 ， 详 细 地 分 析 
MapperScannerConfigurer 所 提供 的 逻辑 实现 。 


1. processPropertyPlaceHolders 属 性 的 处 理 





首先 ， 难 题 就 是 processPropertyPlaceHolders 属 


性 的 处 理 。 或 许 读者 并 未 过 多 接触 此 属性 ， 我 们 只 
He £t & processPropertyPlaceHolders() K ROK Js FEL 
属性 所 代表 的 功能 。 





/* 


* BeanDefinitionRegistries are called early in application s 
tartup, before 

* BeanFactoryPostProcessors. This means that PropertyResourc 
eConfigurers will not have been 

* loaded and any property substitution of this class' proper 
ties will fail. To 
avoid this, find 

* any PropertyResourceConfigurers defined in the context and 

run them on this class' bean 

* definition. Then update the values. 

*/ 
private void processPropertyPlaceHolders() { 

Map<String, PropertyResourceConfigurer> prcs = applicationc 
ontext.getBeansOfType 
(PropertyResourceConfigurer.class); 


if (!prcs.isEmpty() && applicationContext instanceof Generi 
cApplicationContext) { 
BeanDefinition mapperScannerBean - ((GenericApplicationCo 
ntext) applicationContext) 
.getBeanFactory().getBeanDefinition(beanName); 


// PropertyResourceConfigurer does not expose any methods 
to explicitly perform 

// property placeholder substitution. Instead, create a B 
eanFactory that just 

// contains this mapper scanner and post process the fact 
ory. 

DefaultListableBeanFactory factory - new DefaultListableB 
eanFactory(); 

factory.registerBeanDefinition(beanName, mapperScannerBea 


n); 


for (PropertyResourceConfigurer prc : prcs.values()) { 
prc.postProcessBeanFactory(factory); 


j 


PropertyValues values - mapperScannerBean.getPropertyValu 
es(); 


this.basePackage - updatePropertyValue("basePackage", val 
ues); 

this.sqlSessionFactoryBeanName - updatePropertyValue("sql 
SessionFactoryBeanName", values); 

this.sqlSessionTemplateBeanName = updatePropertyValue("sq 
lSessionTemplateBeanName", 
values); 


j 





ARIS 7 a SCRA VEE? 或 许 此 
PRI ASC HS) Wie BA = 25 4E] ERER: 
BeanDefinitionRegistries 会 在 应 用 启动 的 时 候 调 用 ， 
并 且 会 早 于 BeanFactoryPostProcessors 的 调用 ， 这 就 
意味 着 PropertyResourceConfigurers 还 没有 被 加 载 所 
有 对 于 属性 文件 的 引用 将 会 失效 。 为 避免 此 种 情况 
发 生 ， 此 方法 手动 地 找 出 定义 的 
PropertyResourceConfigurers 并 进行 提前 调用 以 保证 
对 于 属性 的 引用 可 以 正常 工作 。 


我 想 读者 已 经 有 所 感情， 结合 之 前 讲 过 的 
PropertyResourceConfigurer 的 用 法 ， 举 例 说 明 一 
下 ， 如 要 创建 配置 文件 如 test.properties， 并 添加 属 
性 对 : 


basePackage-test.mybatis.dao 











然后 在 Spring 配置 文件 中 加 入 属性 文件 解析 
f: 


«bean id="mesHandler" class="org.Springframework.beans.factory. 
config.Property Placeholder Configurer"> 
«property name="locations"> 
<list> 
<value>config/test.properties</value> 


</list> 
</property> 
</bean> 





修改 MapperScannerConfigurer 类 型 的 bean 的 定 
Xa 


«bean class-"org.mybatis.Spring.mapper.MapperScannerConfigurer 
Ws 


<property name="basePackage" value="${basePackage}" /> 


</bean> 





此 时 你 会 发 现 ， 这 个 配置 并 没有 达到 预期 的 效 
果 ， 因 为 在 解析 ${basePackage} 的 时 候 
PropertyPlaceholderConfigurerif iE VA, 198 
是 属性 文件 中 的 属性 还 没有 加 载 至 内存 中 ，Spring 
还 不 能 直接 使 用 它 。 为 了 解决 这 个 问题 ，Spring 提 
供 了 processPropertyPlaceHolders 必 性， 你 需要 这 样 
配置 MapperScannerConfigurer 类 型 的 bean。 








«bean class-"org.mybatis.Spring.mapper.MapperScannerConfigurer 
Ws 


«property name="basePackage" value="test.mybatis.dao" /> 
<property name="processPropertyPlaceHolders" value="true" / 
> 


«/bean» 





通过 processPropertyPlaceHolders 属 性 的 配置 ， 
将 程序 引入 我 们 正在 分 析 的 processProperty 
PlaceHolders 函 数 中 来 完成 属性 文件 的 加 载 。 至 
此 ， 我 们 终于 理 清 了 这 个 属性 的 作用 ， 再 次 回顾 这 
个 函数 所 做 的 事情 。 


1. 找到 所 有 已 经 注册 的 


PropertyResourceConfigurer 类 型 的 bean。 


2. 模拟 Spring 中 的 环境 来 用 处 理 右 。 这 里 通过 
使 用 new DefaultListableBeanFactory() 来 模拟 Spring 
中 的 环境 (完成 处 理 器 的 调用 后 便 失 效 ) ， 将 映射 
HJbean, +s MapperScanner Configurer 类 型 bean 
注册 到 环境 中 来 进行 后 理 器 的 调用 ， 处 理 器 
PropertyPlaceholderConfigurer 调 用 完成 的 功能 ， 

找 出 所 有 bean 中 应 用 属性 文件 的 变量 并 将 换 。 th 
Pie wi, TENDS Va Ja, BIE HP DAY 
MapperScannerConfigurer 类 型 的 bean 如 果 有 引入 属 
性 文件 中 的 属性 那么 已 经 被 蔡 换 了 ， 这 时 ， 再 将 模 
pm 中 相关 的 属性 提取 出 来 应 用 在 真实 的 bean 
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fEpostProcessBeanDefinitionRegistry 77 7X; F n] 
以 看 到 ， 配 置 中 文 持 很 多 属性 的 设 定 ， 但 是 我 们 感 
兴趣 的 或 者 说 影响 扫 摘 结 采 的 并 不 多 ， 属 性 设置 后 
通过 在 scanner.registerFilters() 代 码 中 生成 对 应 的 过 
Vis at ORT tll FF R o 





public void registerFilters() { 
boolean acceptAllInterfaces = true; 











Hz 











// 对 于 annotationc1lass 属 性 的 处 到 




















if (this.annotationClass !- null) ( 
addIncludeFilter(new AnnotationTypeFilter(this.annotation 
Class)); 
acceptAllInterfaces - false; 
} 
// 对 于 markerInterface 属 性 的 处 理 
if (this.markerInterface !- null) { 
addIncludeFilter(new AssignableTypeFilter(this.markerInte 
rface) { 
@Override 


protected boolean matchClassName(String className) { 
return false; 


j 


3): 
acceptAllInterfaces - false; 


j 


if (acceptAllInterfaces) { 
// default include filter that accepts all classes 
addiIncludeFilter(new TypeFilter() { 
public boolean match(MetadataReader metadataReader, Met 
adataReaderFactory metadata 
ReaderFactory) throws IOException { 
return true; 


} 
J): 


3 


// 不 扫描 package-info.java 文 件 
addExcludeFilter(new TypeFilter() 




















public boolean match(MetadataReader metadataReader, Metad 
ataReaderFactory metadata 
ReaderFactory) throws IOException { 
String className = metadataReader.getClassMetadata().ge 
tClassName(); 
return className.endsWith("package-info"); 


} 
J): 
} 








代码 中 得 知 ， 根 据 之 前 属性 的 配置 生成 了 对 应 
DSL UE A e 


1. annotationClass 属 性 处 理 。 


如 末 annotationClass 不 为 空 ， 表 示 用 户 设置 了 
此 属性 ， 那 么 残 要 根据 此 属性 生成 过 滤器 以 保证 达 
到 用 户 想 要 的 效 末 ， 而 封装 此 属性 的 过 小 堪 就 是 
AnnotationTypeFilter. Annotation TypeFilter 保 证 在 
扫 摘 对 应 Java 文 件 时 只 接受 标记 有 注解 为 
annotationClass 的 接口 。 








2. markerInterface 属 性 处 理 。 


如 果 markerInterface 不 为 空 ， 表 示 用 户 设置 了 
此 属性 ， 那 么 束 要 根据 此 属性 生成 过 滤器 以 保证 达 
到 用 户 想 要 的 效果 ， 而 封装 此 属性 的 过 滤 强 就 是 实 








现 AssignableTypeFilter 接 口 的 局 部 类 。 表 示 扫 描 过 
程 中 只 有 实现 markerInterface 接 口 的 接口 才 会 被 接 
=, 


X o 
3. 全 局 默认 处 理 。 


在 上 面 两 个 属性 中 如 采 存 在 其 中 任何 属性 ， 
acceptAllInterfaces 的 值 将 会 变 改 变 ， 但 是 如 采用 户 
没有 设 定 以 上 两 个 属性 ， 那 么 ，Spring 会 为 我 们 增 
加 一 个 默认 的 过 小 器 实现 TypeFilter 接 口 的 局 部 类 ， 
由 在 接受 所 有 接口 文件 。 











4. package-info.java 处 理 。 


对 于 命名 为 package-info 的 Java 文件 ， 默 认 不 
作为 逻辑 实现 接口 ， 将 其 排除 挥 ， 使 用 TypeFilter 接 
口 的 局 部 类 实现 match 方 法 。 


从 上 面 的 函数 我 们 看 出 ， 控 制 扫 摘 文 件 Spring 
通过 不 同 的 过 滤器 完成 ， 这 些 定 义 的 过 滤器 记录 在 
了 includeFilters 和 excludeFilters 属 性 中 。 








public void addIncludeFilter(TypeFilter includeFilter) { 
this.includeFilters.add(includeFilter); 


public void addExcludeFilter(TypeFilter excludeFilter) { 


this.excludeFilters.add(0, excludeFilter); 
} 
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3. 扫描 Java 文 件 


设置 了 相关 属性 以 及 生成 了 对 应 的 过 滤 强 后 便 
可 以 进行 文件 的 扫描 了 ， 扫 描 工 作 是 由 
ClassPathMapperScanner 类 型 的 实例 scanner 中 的 scan 
方法 完成 的 。 
public int scan(String... basePackages) ( 


int beanCountAtScanStart - this.registry.getBeanDefini 
tionCount(); 


doScan(basePackages); 
































// 如 果 配 置 了 includeAnnotationconfig， 则 注册 对 应 注解 的 处 理 器 以 保证 
注解 功能 的 正常 使 用 。 
if (this.includeAnnotationConfig) { 
AnnotationConfigUtils.registerAnnotationConfigProc 
essors(this.registry); 








return this.registry.getBeanDefinitionCount() - beanCo 
untAtScanStart; 
} 





scan 是 个 全 局 方法 ， 扫 摘 工 作 通 过 
doScan(basePackages) 委 托 给 了 doScan 方 法 ， 同 时 ， 
还 包括 了 includeAnnotationConfig 属 性 的 处 理 ， 
AnnotationConfigUtils.registerAnnotation 
ConfigProcessors (this.registry) 代 人 码 主 要 是 完成 对 于 





注解 处 理 絮 的 简单 注册 ， 比 如 
AutowiredAnnotationBeanPost Processor, 
Mc cane piu » HA 


资 述 ， 我 们 重点 研究 文件 扫描 功能 的 实现 。 


ClassPathMapperScanner.java 








public Set«BeanDefinitionHolder» doScan(String... basePackages) 


Set«BeanDefinitionHolder» beanDefinitions - super.doScan 
(basePackages); 


if (beanDefinitions.isEmpty()) { 
// 如 果 没 有 扫描 到 任何 文件 发 出 警告 























logger.warn("No MyBatis mapper was found in '" + Arrays.t 
oString(basePackages) + "' package. Please check your configura 
tion."); 
) else { 


for (BeanDefinitionHolder holder : beanDefinitions) { 
GenericBeanDefinition definition - (GenericBeanDefiniti 
on) holder.getBeanDefinition(); 


if (logger.isDebugEnabled()) { 
logger.debug("Creating MapperFactoryBean with name '" 
* holder.getBeanName() 


+ "' and '" + definition.getBeanClassName() + "' 
mapperInterface"); 


// 开 始 构造 MapperFactoryBean 类 型 的 bean . 

definition.getPropertyValues().add("mapperInterface", d 
efinition.getBeanClassName()); 

definition.setBeanClass(MapperFactoryBean.class); 


definition.getPropertyValues().add("addToConfig", this. 
addToConfig); 


boolean explicitFactoryUsed - false; 


if (StringUtils.hasText(this.sqlSessionFactoryBeanName ) 
) i 
definition.getPropertyValues().add("sqlSessionFactory 
", new RuntimeBeanReference 
(this.sqlSessionFactoryBeanName)); 
explicitFactoryUsed - true; 
) else if (this.sqlSessionFactory !- null) { 
definition.getPropertyValues().add("sqlSessionFactory 
", this.sqlSessionFactory); 
explicitFactoryUsed - true; 


j 


if (StringUtils.hasText(this.sqlSessionTemplateBeanName 
)) 4 
if (explicitFactoryUsed) { 
logger.warn("Cannot use both: sqlSessionTemplate an 
d sqlSessionFactory 
together. sqlSessionFactory is ignored."); 


definition.getPropertyValues().add("sqlSessionTemplat 
e", new RuntimeBeanReference (this.sqlSessionTemplateBeanName)) 

explicitFactoryUsed - true; 

) else if (this.sqlSessionTemplate !- null) ( 
if (explicitFactoryUsed) { 
logger.warn("Cannot use both: sqlSessionTemplate an 

d sqlSessionFactory 
together. sqlSessionFactory is ignored."); 

} 

definition.getPropertyValues().add("sqlSessionTemplat 
e", this.sqlSessionTemplate) ; 

explicitFactoryUsed = true; 


} 


if (!explicitFactoryUsed) { 
if (logger.isDebugEnabled()) { 
logger .debug("Enabling autowire by type for MapperF 
actoryBean with name '" + holder.getBeanName() + "'."); 
} 
definition.setAutowireMode(AbstractBeanDefinition.AUT 
OWIRE BY TYPE); 


j 
j 


MEM 


TIN, BALRA TRIAR, fH 
是 我 们 也 应 该 理解 了 Spring 中 对 于 上 自动 扫描 的 注 
册 ， 声 明 MapperScannerConfigurer 类 型 的 bean 目 的 
是 不 需要 我 们 对 于 每 个 接口 都 注册 一 个 
MapperFactoryBean 类 型 的 对 应 的 bean， 但 是 ， 不 在 
配置 文件 中 注册 并 不 代表 这 个 bean 不 存在 ， 而 是 在 
扫描 的 过 程 中 通过 编码 的 方式 动态 注册 。 实 现 过 程 
我 们 在 上 面 的 函数 中 可 以 看 得 非 音 清楚 。 





protected Set«BeanDefinitionHolder» doScan(String... basePackag 


es) { 


Assert.notEmpty(basePackages, "At least one base packa 
ge must be specified"); 
Set«BeanDefinitionHolder» beanDefinitions - new Linked 
HashSet «BeanDefinition Holder>(); 
for (String basePackage : basePackages) { 
// 扫 描 basePackage 路 径 下 java 文 件 
Set«BeanDefinition» candidates = findCandidateComp 




















onents 


(basePackage); 
for (BeanDefinition candidate : candidates) { 
// 解 析 scope 属 性 
ScopeMetadata scopeMetadata = this.scopeMetada 
taResolver.resolveScopeMetadata (candidate); 








candidate.setScope(scopeMetadata.getScopeName( 
)); 

String beanName - this.beanNameGenerator.gener 
ateBeanName(candidate, this.registry); 

if (candidate instanceof AbstractBeanDefinitio 
n) { 

postProcessBeanDefinition((AbstractBeanDef 

inition) candidate, 
beanName ) ; 


if (candidate instanceof AnnotatedBeanDefiniti 


on) { 
// 如 果 是 AnnotatedBeanDefinition 类 型 的 bean, 需 
要 检测 下 常用 注解 如 : Primary、Lazy 等 
AnnotationConfigUtils.processCommonDefinit 











ionAnnotations 
((AnnotatedBeanDefinition) candidate); 


// 检 测 当 前 bean 是 否 已 经 注册 
if (checkCandidate(beanName, candidate)) { 
BeanDefinitionHolder definitionHolder - ne 
w BeanDefinitionHolder (candidate, beanName); 
// 如 果 当 前 bean 是 用 于 生成 代理 的 bean 那 么 需要 进一步 






































处 理 





definitionHolder = AnnotationConfigUtils.a 
pplyScopedProxyMode 
(scopeMetadata, definitionHolder, this.registry); 
beanDefinitions.add(definitionHolder); 
registerBeanDefinition(definitionHolder, t 
his.registry); 


} 
} 
} 
return beanDefinitions; 
} 
public Set<BeanDefinition> findCandidateComponents(String baseP 
ackage) { 


Set«BeanDefinition» candidates - new LinkedHashSet«Bea 
nDefinition>(); 
try { 
String packageSearchPath = ResourcePatternResolver 
CLASSPATH_ ALL_URL 
PREFIX + 





resolveBasePackage(basePackage) + "/" + th 
is.resourcePattern; 
Resource[] resources = this.resourcePatternResolve 
r.getResources (package SearchPath); 
boolean traceEnabled = logger.isTraceEnabled(); 
boolean debugEnabled = logger.isDebugEnabled(); 
for (Resource resource : resources) { 
if (traceEnabled) { 
logger.trace("Scanning " + resource); 


j 


if (resource.isReadable()) { 


try { 
MetadataReader metadataReader - this.m 
etadataReaderFactory. 
getMetadataReader(resource); 
if (isCandidateComponent 


(metadataReader)) ( 
ScannedGenericBeanDefinition sbd - 
new ScannedGenericBean 
Definition(metadataReader); 
sbd.setResource(resource); 
sbd.setSource(resource); 
if (isCandidateComponent(sbd)) ( 
if (debugEnabled) { 
logger.debug("Identified c 
andidate component class 
" * resource); 


candidates.add(sbd); 


} 
else ( 
if (debugEnabled) { 
logger.debug("Ignored beca 
use not a concrete top-level class: " + resource); 
} 
} 
} 
else ( 
if (traceEnabled) { 
logger.trace("Ignored because 
not matching any filter: 
" * resource); 
} 
} 


} 
catch (Throwable ex) { 
throw new BeanDefinitionStoreException 


( 
"Failed to read candidate comp 
onent class: " + resource, ex); 
} 
} 
else ( 


if (traceEnabled) { 
logger.trace("Ignored because not read 


able: " + resource); 
} 
} 
} 


} 
catch (IOException ex) { 
throw new BeanDefinitionStoreException("I/O failur 
e during classpath 
scanning", ex); 


return candidates; 





findCandidateComponents 方 法 根据 传 入 的 包 路 
径 信 息 并 绪 合 类 文 件 路 径 拼接 成 文件 的 绝对 路 径 ， 








同时 完成 了 文件 的 扫描 过 程 并 且 根 据 对 应 的 文件 生 
成 了 对 应 的 bean， 使 用 
ScannedGenericBeanDefinition 类 型 的 bean 承 载 信 

M, beant KWX I resource source] m. AE, 
我 们 更 感 兴趣 的 是 
isCandidateComponent(metadataReader), Jt“) (R43 
用 于 判断 当前 扫 摘 的 文件 是 人 否 符 合 要 求 ， 而 我 们 之 
前 注册 的 一 些 过 小 器 信息 也 正 是 在 此 时 派 上 用 场 

的 。 














protected boolean isCandidateComponent(MetadataReader metadataR 
eader) throws IOException { 
for (TypeFilter tf : this.excludeFilters 


) { 
if (tf.match 


(metadataReader, this.metadataReaderFactory)) ( 


return false; 


j 


} 
for (TypeFilter tf : this.includeFilters 


) { 
if (tf.match 


(metadataReader, this.metadataReaderFactory)) ( 

AnnotationMetadata metadata - metadataReader.g 
etAnnotationMetadata(); 

if (!metadata.isAnnotated(Profile.class.getNam 
e())) t 

return true; 

} 

AnnotationAttributes profile = MetadataUtils.a 
ttributesFor(metadata, Profile.class); 

return this.environment.acceptsProfiles(profil 
e.getStringArray("value")); 

} 


return false; 








我 们 看 到 了 之 前 加 入 过 滤器 的 两 个 属性 
excludeFilters、includeFilters， 并 有 旦 知道 对 应 的 文件 





是 否 符合 要 求 是 根据 过 滤器 中 的 match 方 法 所 返回 
的 信息 来 判断 的 ， 当 然 用 户 可 以 实现 并 注册 满足 自 
己 业 务 逻 辑 的 过 滤器 来 控制 扫描 的 结果 ， 
metadataReader 中 有 你 过 滤 所 需要 的 全 部 文件 信 

居 。 人 至 此 ， 我 们 完成 了 文件 的 扫描 过 程 的 分 析 。 








第 10 草 ”事务 


Spring 声明 式 事务 让 我 们 从 复杂 的 事务 处 理 中 
得 到 解脱 ， 使 我 们 再 也 不 需要 去 处 理 获得 连接 、 关 
闭 连 接 、 事 务 提交 和 回 深 每 操作 ， 再 也 不 需要 在 与 
事务 相关 的 方法 中 处 理 大 量 的 try...catch...finally 代 
人 码 。Spring 中 事务 的 使 用 虽然 已 经 相对 简单 得 多 ， 
但 是 ， 还 是 有 很 多 的 使 用 及 配置 规则 ， 有 兴趣 的 读 
者 可 以 目 己 伍 赔 相关 资料 进行 深入 研究 ， 这 里 只 列 
举 出 最 单 用 的 使 用 方法 。 


E 同样 ， 我 们 还 是 以 最 简单 的 示例 来 进行 直观 地 


ST ZB 

















10.1 JDBC 方 式 下 的 事务 使 用 示例 


1. 创建 数据 表 结 构 





CREATE TABLE 'user' ( 
'id' int(11) NOT NULL auto increment, 
'name' varchar(255) default NULL, 
'age' int(11) default NULL, 
'sex' varchar(255) default NULL, 
PRIMARY KEY ('id') 


) ENGINE-InnoDB DEFAULT CHARSET=utf8; 


2. 创建 对 应 数据 表 的 PO 


public class User { 


private int id; 

private String name; 

private int age; 
private String sex; 





// 省 略 set/get 方 法 
} 





3. 创建 表 与 实体 间 的 映射 


public class UserRowMapper implements RowMapper { 


QOverride 
public Object mapRow(ResultSet set, int index) throws SQLEx 
ception ( 
User person = new User(set.getInt("id"), set.getString( 


"name"), set 


.getInt("age"), set.getString("sex")); 
return person; 





4. 创建 数据 操作 接口 


@Transactional(propagation=Propagation.REQUIRED) 
public interface UserService { 


public void save(User user) throws Exception; 





5. 创建 数据 操作 接口 实现 类 


public class UserServicelmpl implements UserService { 
private JdbcTemplate jdbcTemplate; 


// 设置 数据 源 

public void setDataSource(DataSource dataSource) ( 
this.jdbcTemplate - new JdbcTemplate(dataSource); 

} 


public void save(User user) throws Exception { 
jdbcTemplate.update("insert into user(name,age,sex)valu 
es(?,?,?)", 
new Object[] { user.getName(), user.getAge(), 
user.getSex() }, new int[] { java.sql.T 
ypes.VARCHAR, 
java.sql.Types.INTEGER, java.sql.Types. 
VARCHAR }); 





// 事 务 测 试 ， 加 上 这 人 句 代 码 则 数据 不 会 保存 到 数据 库 中 


throw new RuntimeException("aa"); 





6. 创建 Spring 配置 文件 





<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns:tx-'http://www.Springframework.org/schema/tx" 


xmlns:context-"http://www.Springframework.org/schema/conte 
xt" 
xsi:schemaLocation-z" 
http://www.Springframework.org/schema/beans http:/ 
/www.Springframework.org/ 
schema/beans/Spring-beans-2.5.xsd 
http://www.Springframework.org/schema/context htt 
p://www.Springframework. 
org/schema/context/Spring-context-2.5.xsd 
http://www.Springframework.org/schema/tx http://w 
ww.Springframework.org/ schema/tx/Spring-tx-2.5.xsd 
"s 


<tx:annotation-driven transaction-manager="transactionMana 
ger" /> 


<bean id="transactionManager 


class="org.Springframework.jdbc.datasource.DataSourceT 
ransactionManager "> 
<property name="dataSource" ref="dataSource" /> 
</bean> 














<!- -配置 数据 源 --> 
«bean id="dataSource" class="org.apache.commons.dbcp.Basic 
DataSource" 
destroy-method="close"> 
<property name="driverClassName" value="com.mysql.jdbc 
.Driver" /> 
«property name="url" value="jdbc:mysql://localhost : 330 
6/lexueba" /> 
«property name-"username" value="root" /> 
«property name="password" value="hao0jia0421xixi" /> 
«1-- 连接 池 局 动 时 的 初始 值 --> 
«property name="initialSize" value="1" /> 
<!-- 连接 池 的 最 大 值 --> 
«property name="maxActive" value="300" /> 
«1-- 最 大 空闲 值 . 当 经 过 一 个 高 峰 时 间 后 ， 连 接 池 可 以 慢 慢 将 已 经 用 不 到 
的 连接 慢 慢 释放 一 部 分 ， 一直 减少 到 maxIdle 为 止 --> 
«property name="maxIdle" value="2" /> 
«1-- 最 小 空间 值 .当空 间 的 连接 数 少 于 阀 值 时 ， 连 接 池 就 会 预 申请 去 一 些 


























连接 ， 以 免 洪 峰 来 时 来 不 及 申请 - -> 
«property name="minIdle" value="1" /> 
</bean> 

















<!-- 配置 业务 bean: PersonServiceBean --> 

«bean id="userService" class-'service.UserServicelImpl'- 
<!-- 向 属性 dataSource 注 入 数据 源 --> 
<property name="dataSource" ref="dataSource"></propert 





y> 


</bean> 
</beans> 





7. 测试 


public static void main(String[] args) throws Exception { 
ApplicationContext act - new ClassPathXmlApplicationCo 
ntext("bean.xm1l"); 


UserService userService - (UserService) act.getBean("u 
serService"); 

User user - new User(); 

user.setName("7K-—ccc"); 


user.setAge(20); 
user.setSex(" 5$"); 

// 保存 一 条 记录 
userService.save(user); 




















在 上 面 的 测试 示例 中 ，UserServiceImpl 类 对 接 
口 UserService 中 的 save 函数 的 实现 最 后 加 入 了 一 句 
抛 出 异 音 的 代码 : throw new 
RuntimeException("aa)。 当 注 掉 这 段 代 人 码 执行 测试 


类 ， 那 么 会 看 到 数据 被 成 功 的 保存 到 了 数据 库 中 ， 
但 是 如 果 加 入 这 上 段 代码 时 再 次 运行 测试 类 ， 友 现 此 
处 的 操作 并 不 会 将 数据 保存 到 数据 库 中 。 


默认 情况 下 Spring 中 的 事务 处 理 只 对 RuntimeException 方 法 
进行 回 演 ， 所 以 ， 如 果 此 处 将 Runtime Exception f 35 X; 3E 38 AY 
Exception Rr E RAR. 





10.2 事务 日 定义 标签 


对 于 Spring 中 事务 功能 的 代码 分 析 ， 我 们 首先 
从 配置 文件 开始 入 手 ， 在 配置 文件 中 有 这 样 一 个 配 
“i: <tx:annotation-driven />。 可 以 说 此 处 配置 是 事 
务 的 开关 ， 如 果 没 有 此 处 配置 ， 那 么 Spring 中 将 不 
存在 事务 的 功能 。 那 么 我 们 就 从 这 个 配置 开始 分 


o 


根据 之 前 的 分 机 ， 我 们 因此 可 以 判断 ， 和 在 目 定 
义 标签 中 的 解析 过 程 中 一 定 是 做 了 一 些 辅助 操作 ， 
于 古 我 们 先 从 目 定 义 标 答 入 手 进 行 分 析 。 


使 用 Eclipse 搜 索 全 局 代码 ， 关 键 字 annotation- 
drive， 最 终 锁 定 类 TxNamespaceHandler， 在 


TxNamespaceHandler t? HJinit77 2X; F: 


public void init() { 
registerBeanDefinitionParser("advice", new TxAdviceBea 
nDefinitionParser()); 
registerBeanDefinitionParser("annotation-driven 


", new AnnotationDrivenBean 
DefinitionParser 


0); 


registerBeanDefinitionParser("jta-transaction-manager" 
, new JtaTransactionManagerBean 
DefinitionParser()); 


j 





根据 目 定 义 标 签 的 使 用 规则 以 及 上 面 的 代码 ， 
可 以 知道 ， 在 遇 到 诸如 <tx:annotation-driven 为 开头 
的 配置 后 ，Spring 都 会 使 用 


AnnotationDrivenBeanDefinitionParser 类 的 parse 方 法 


进行 解析 。 








public BeanDefinition parse(Element element, ParserContext pars 
erContext) { 
String mode - element.getAttribute("mode"); 
if ("aspectj".equals(mode)) { 
// mode="aspectj" 
registerTransactionAspect(element, parserContext); 
jelse ( 
// mode="proxy" 
AopAutoProxyConfigurer.configureAutoProxyCreator 


(element, parserContext); 


return null; 


在 解析 中 存在 对 于 mode 属 性 的 判断 ， 根 据 代 
人 码 ， 如 果 我 们 需要 使 用 AspectJ 的 方式 进行 事务 切入 
(Spring 中 的 事务 是 以 AOP 为 基础 的 ) ， 那 么 可 以 
使 用 这 样 的 配置 : 








«tx:annotation-driven transaction-manager-"transactionMana 
ger" mode="aspectj" 


/? 





10.2.1 注册 
InfrastructureAdvisorAutoProxyCreator 


我 们 以 默认 配置 为 例子 进行 分 机 ， 进 入 
AopAutoProxyConfigurer 类 的 
configureAutoProxyCreator: 





public static void configureAutoProxyCreator(Element element, P 
arserContext parserContext) { 

AopNamespaceUtils.registerAutoProxyCreatorIfNecess 
ary(parserContext, element); 


//TRANSACTION_ADVISOR_BEAN_NAME ="org.Springframework.transacti 
on.config.internal TransactionAdvisor"; 

String txAdvisorBeanName - TransactionManagementCo 
nfigUtils.TRANSACTION ADVISOR BEAN NAME; 


if (!parserContext.getRegistry().containsBeanDefin 
ition (txAdvisorBean Name)) { 
Object eleSource - parserContext.extractSource 
(element); 





//&|&&TransactionAttributeSourcelff]bean 
RootBeanDefinition sourceDef - new RootBeanDef 
inition (Annotation 
TransactionAttributeSource 


.class); 
sourceDef .setSource(eleSource) ; 
sourceDef.setRole(BeanDefinition.ROLE INFRASTR 
UCTURE); 
// 注 册 bean, 并 使 用 Spring 中 的 定义 规则 生成 beanname 
String sourceName = parserContext.getReaderCon 
text(). RegisterWith 
GeneratedName (sourceDef); 








// 创 建 TransactionInterceptor 的 bean 
RootBeanDefinition interceptorDef = new RootBe 
anDefinition 
(TransactionInterceptor 


.class); 
interceptorDef.setSource(eleSource); 
interceptorDef.setRole(BeanDefinition.ROLE INF 
RASTRUCTURE ) ; 
registerTransactionManager(element, intercepto 
rDef); 
interceptorDef.getPropertyValues().add("transa 
ctionAttributeSource", new RuntimeBeanReference(sourceName)); 
// 注 册 bean, 并 使 用 Spring 中 的 定义 规则 生成 beanname 
String interceptorName = parserContext.getRead 
erContext(). Register 
WithGeneratedName(interceptorDef); 








//&|f&TransactionAttributeSourceAdvisorfB'Jbean 
RootBeanDefinition advisorDef - new RootBeanDe 
finition (BeanFactory 
TransactionAttributeSourceAdvisor 


.class); 
advisorDef.setSource(eleSource); 
advisorDef.setRole(BeanDefinition.ROLE INFRAST 


RUCTURE); 
// 将 sourceName 的 bean 注 入 advisorDef 的 transactionAttr 
ibuteSource 属 性 中 





advisorDef.getPropertyValues().add("transactio 
nAttributeSource", new RuntimeBeanReference(sourceName)); 


// 将 interceptorName 的 bean 注入 advisorDef 的 adviceBeanN 
ame 属 性 中 





advisorDef.getPropertyValues().add("adviceBean 
Name", interceptorName); 

















// 如 果 配 置 了 order 属 性 ， 则 加 入 到 bean 中 
if (element.hasAttribute("order")) ( 
advisorDef.getPropertyValues().add("order" 
, element.getAttribute 
("order")); 


Jj 


parserContext.getRegistry().registerBeanDefini 
tion(txAdvisorBeanName, advisorDef); 





//&]s&CompositeComponentDefinition 
CompositeComponentDefinition compositeDef - ne 
w CompositeComponent 
Definition(element.getTagName(), eleSource); 
compositeDef.addNestedComponent(new BeanCompon 
entDefinition (sourceDef, sourceName)); 
compositeDef.addNestedComponent(new BeanCompon 
entDefinition(interceptorDef, interceptorName)); 
compositeDef.addNestedComponent(new BeanCompon 
entDefinition(advisorDef, txAdvisorBeanName)); 
parserContext.registerComponent(compositeDef); 


j 





上 面 的 代码 注册 了 代理 类 及 3 个 bean， 人 很 多 读 
者 会 直接 略 过 ， 认 为 只 是 注册 3 个 bean 而 已 ， 确 


这 里 只 注册 了 3 个 bean， dur d 
整个 的 事务 功能 ， 那 么 这 3 个 bean 是 怎么 组 织 起 来 
的 呢 ? 


首先 ， 其 中 的 两 个 bean 被 注册 到 了 一 个 名 为 
advisorDef 的 bean 中 ，advisorDef 使 用 
BeanFactoryTransactionAttributeSourceAdvisor 作 为 
其 class 必 性。 也 束 是 说 BeanFactoryTransaction 
AttributeSourceAdvisor 代 表 痢 当前 bean， 如 图 10-1 
Bran, BERI P: 


advisorDef.getPropertyValues().add("adviceBeanName", inter 


ceptorName); 





BeanFactoryTransactionAttributeSourceAdvisor 
| 


C i 
z ` 
> N 


AnnotationTransactionAttributeSource Trans actionInterceptor 


图 10-1 BeanFactoryTransactionAttributeSourceA dvisorf') 2H 4% 


ABA BU CZHAREIT] Ae ANE? 我 们 暂且 留 下 
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configureAutoProxyCreator 中 的 第 一 句 貌 似 很 简单 但 
却 是 很 重要 的 代码 : 


AopNamespaceUtils.registerAutoProxyCreatorIfNecessary(parserCon 
text, element); 





进入 这 个 图 数 : 


public static void registerAutoProxyCreatorIfNecessary( 
ParserContext parserContext, Element sourceElement 


Fa 


BeanDefinition beanDefinition = AopConfigUtils.registe 
rAutoProxyCreatorIf 
Necessary 


( 


parserContext.getRegistry(), parserContext.ext 
ractSource (source 
Element)); 
useClassProxyinglIfNecessary(parserContext.getRegistry( 
), sourceElement); 
registerComponentIfNecessary(beanDefinition, parserCon 
text); 


j 


public static BeanDefinition registerAutoProxyCreatorIfNecessar 
y(BeanDefinitionRegistry 
registry, Object source) ( 
return registerOrEscalateApcAsRequired(InfrastructureA 
dvisorAutoProxyCreator 


class, registry, source); 


J 





对 于 解析 来 的 代码 流程 AOP 中 已 经 有 所 分 析 ， 
上 上 面 的 两 个 函数 主要 目的 是 注册 了 
InfrastructureAdvisorAutoProxyCreator 类 型 的 bean， 
那么 注册 这 个 类 的 目的 是 什么 呢 ? 得 看 这 个 类 的 层 
次 ， 如 图 10-2 所 示 。 


[TS E 
2 E) InfrastructureAdvisorAutoProxyCreator 
4 (9^ AbstractAdvisorAutoProxyCreator 
E) 9^ AbstractAutoProxyCreator 
4 (9 ProxyConfig 
(9 Objec 
@ Serializable 


AoplnfrastructureB ean 








BeanClassLoaderAware 
@ Aware 
BeanFactoryAware 

Q Aware 

Ordered 


SmartInstantiationAwareB eanPostProcessor 
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© Instantiation/wareBeanPostProcessor 


@ BeanPostProcessor 





410-2 InfrastructureAdvisorAutoProxyCreator 类 的 层次 结构 图 


从 上 面 的 层次 结构 中 可 以 看 到 ， 
InfrastructureAdvisorAutoProxyCreator|E] ZZ SIC 3Jl f 
SmartInstantiationA wareBeanPostProcessor, 而 
SmartInstantiationA wareBeanPostProcessor X. 4k 7K EH 
InstantiationAwareBeanPostProcessor, tit ét 


Spring 中 ， 所 有 bean 实 例 化 时 Spring 都 会 保证 调用 其 














postProcessAfterInitialization 方 法 ， 其 实现 是 在 父 类 
AbstractAutoProxyCreator 类 中 实现 。 


以 之 前 的 示例 为 例 ， 当 实例 化 userService 的 
bean 时 便 会 调用 此 方法 ， 方 法 如 下 : 


public Object postProcessAfterInitialization(Object bean, Strin 
g beanName) throws 
BeansException ( 
if (bean != null) { 
// 根 据 给 定 的 bean 的 class 和 name 构 建 出 个 key，beanClassNam 








e_beanName 
Object cacheKey = getCacheKey(bean.getClass(), bea 
nName); 























// 是 否 是 由 于 避免 循环 依赖 而 创建 的 bean 代 理 
if (!this.earlyProxyReferences.contains(cacheKey)) 

















return wrapIfNecessary 


(bean, beanName, cacheKey); 


j 


return bean; 








这 里 实现 的 主要 目的 是 对 指定 bean 进 行 封 装 ， 
当然 首先 要 确定 是 侣 需要 封闭， 检测 及 封 逆 的 工作 
都 委托 给 了 wrapIfNecessary 函 数 进行 。 











protected Object wrapIfNecessary(Object bean, String beanName, 
Object cacheKey) { 

















// 如 果 已 经 处 理 过 
if (this.targetSourcedBeans.contains(beanName)) { 
return bean; 





if (this.nonAdvisedBeans.contains(cacheKey)) { 
return bean; 
} 
// 给 定 的 bean 类 是 否 代表 一 个 基础 设施 类 ， 不 应 代理 ， 或 者 配置 了 指定 be 
an 不 需要 自动 代理 
if (isInfrastructureClass(bean.getClass()) || shouldSk 
ip(bean.getClass(), 
beanName)) { 
this.nonAdvisedBeans.add(cacheKey); 
return bean; 




































































j 


// Create proxy if we have advice. 
Object[] specificInterceptors = getAdvicesAndAdvisorsF 
orBean 


(bean.getClass(), beanName, null); 
if (specificlInterceptors !- DO NOT PROXY) { 

this.advisedBeans.add(cacheKey); 
Object proxy = createProxy(bean.getClass(), beanNa 

me, specificInterceptors, 

new SingletonTargetSource(bean)); 
this.proxyTypes.put(cacheKey, proxy.getClass()); 
return proxy; 


j 


this.nonAdvisedBeans.add(cacheKey); 
return bean; 








wrapIfNecessary 函 数 功 能 实现 起 来 很 复杂 ， 但 
是 逻辑 上 理解 起 来 还 是 相对 人 简单 的 ， 在 
wraplfNecessary R Zi rp 3: E EP] CEM T e 


。 找 出 指定 bean 对 应 的 增强 器 。 
。 根 据 找 出 的 增强 右 创 建 代理 。 


Ur RALLY fi] FLA, Spring A fit f pus 
复杂 的 工作 呢 ? 对 于 创建 代理 的 部 分 ， 通 过 之 前 的 
分 析 相 信 大 家 已 经 很 熟悉 了 ， 但 是 对 于 增强 右 的 获 
取 ，Spring 又 是 怎么 做 的 呢 ? 


10.2.2 ”获取 对 应 class/method 的 增强 器 





获取 指定 pean 对 应 的 增强 器 ， 其 中 包含 两 个 关 
键 字 : 增强 右 与 对 应 。 也 就 是 说 在 
getAdvicesAndAdvisorsForBean 函 数 中 ， 不 但 要 找 出 
增强 器 ， 而 且 还 需要 判断 增强 需 是 售 满 足 要 求 。 














protected Object[] getAdvicesAndAdvisorsForBean(Class beanClass 
, String beanName, 
TargetSource targetSource) ( 

List advisors - findEligibleAdvisors(beanClass, beanNa 


me); 
if (advisors.isEmpty()) { 
return DO NOT PROXY; 
} 
return advisors.toArray(); 
} 


protected List<Advisor> findEligibleAdvisors(Class beanClass, S 
tring beanName) { 
List<Advisor> candidateAdvisors = findCandidateAdvisors 


List<Advisor> eligibleAdvisors = findAdvisorsThatCanAp 


(candidateAdvisors, beanClass, beanName) ; 
extendAdvisors(eligibleAdvisors); 
if (!eligibleAdvisors.isEmpty()) { 
eligibleAdvisors - sortAdvisors(eligibleAdvisors); 


} 
return eligibleAdvisors; 
} 


其 实 我 们 也 渐渐 地 体会 到 了 Spring 中 代码 的 优 
Fs, BEE “MR ARIE, FE Spring 中 也 会 被 
拆 分 成 在 干 个 小 的 逻辑 ， 然 后 在 每 个 函数 中 实现 ， 
使 得 每 个 函数 的 馆 辑 简单 到 我 们 能 快速 地 理解 ， 而 
不 会 像 有 些 人 开 友 的 那样 ， 将 一 大 堆 的 逻辑 都 罗列 
在 一 个 函数 中 ， 给 后 期 维护 人 员 造 成 巨大 的 困扰 。 


同样 ， 通 过 上 和 面 的 函数 ，Spring 叉 将 任务 进行 
SiR, DTE TRAA EAr- eB at ee To VE 
两 个 功能 点 。 
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在 findCandidateAdvisors 函 数 中 完成 的 就 是 获 
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protected List«Advisor» findCandidateAdvisors() ( 
return this.advisorRetrievalHelper.findAdvisorBeans 


(0; 
} 


public List<Advisor> findAdvisorBeans() { 

// Determine list of advisor bean names, if not cached 
already. 

String[] advisorNames = null; 


synchronized (this) { 
advisorNames - this.cachedAdvisorBeanNames; 
if (advisorNames == null) { 
advisorNames = BeanFactoryUtils.beanNamesForTy 
peIncludingAncestors( 


this.beanFactory, Advisor.class, true, 
false); 


this.cachedAdvisorBeanNames = advisorNames; 


j 


if (advisorNames.length -- 0) ( 
return new LinkedList<Advisor>(); 


j 


List<Advisor> advisors = new LinkedList<Advisor>(); 
for (String name : advisorNames) { 
if (isEligibleBean(name) && !this.beanFactory.isCu 
rrentlyInCreation(name)) ( 
try { 
advisors.add(this.beanFactory.getBean(name 
, Advisor.class) 


); 


j 


catch (BeanCreationException ex) { 
Throwable rootCause - ex.getMostSpecificCa 
use(); 
if (rootCause instanceof BeanCurrentlyInCr 
eationException) { 
BeanCreationException bce = (BeanCreat 
ionException) rootCause; 
if (this.beanFactory.isCurrentlyInCrea 
tion(bce.getBeanName())) { 
if (logger.isDebugEnabled()) { 
logger.debug("Ignoring current 


ly created advisor '" + name + "': " + ex.getMessage( )); 
} 
continue; 


throw ex; 
} 
} 


return advisors; 





WT Emmys. dye EC AY Bab Ig? 首 
先是 通过 BeanFactoryUtils 类 提供 的 工具 方法 获取 所 





有 对 应 Advisor.class 的 类 ， 获 取 办 法 无 非 是 使 用 
ListableBeanFactory 中 提供 的 方法 : 


String[] getBeanNamesForType(Class<?> type, boolean includeNonS 
ingletons, boolean allowEagerInit); 


而 当 我 们 知道 增强 器 在 容器 中 的 beanName 
时 ， 获 取 增 强 吉 已 经 不 是 问题 了 ， 在 BeanFactory 中 
提供 了 这 样 的 方法 ， 可 以 帮助 我 们 快速 定位 对 应 的 
bean 实 例 。 


<T> T getBean(String name, Class<T> requiredType) throws BeansE 
xception; 


或 许 你 已 经 筷 了 之 前 留 下 的 基 念 ， 在 我 们 讲解 
目 定 义 标签 时 曾经 注册 了 一 个 类 型 为 
BeanFactoryTransactionAttributeSourceAdvisor 的 


bean， 而 在 此 bean 中 我 们 又 注入 了 另外 两 个 Bean， 
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BeanFactoryTransactionAttribute Source Advisor 同 样 
也 实现 了 Advisor 接 口 ， 那 么 在 获取 所 有 增强 器 时 目 
然 也 会 将 此 bean 提 取出 来 ， 并 随 着 其 他 增强 絮 一 起 
在 后 续 的 步 又 中 被 织 入 代理 。 





2， 候 选 增强 磺 中 寻找 到 匹配 项 





当 找 出 对 应 的 增强 器 后 ， 接 来 的 任务 就 是 看 这 
些 增强 器 是 否 与 对 应 的 class 匹 配 了 ， 当 然 不 只 是 
class，class 内 部 的 方法 如 果 匹 配 也 可 以 通过 验证 。 








public static List<Advisor> findAdvisorsThatCanApply(List<Advis 
or» candidateAdvisors, Class<?> clazz) { 
if (candidateAdvisors.isEmpty()) { 
return candidateAdvisors; 


List<Advisor> eligibleAdvisors = new LinkedList<Adviso 
r>(); 














// 首 先 处 理 引 介 增 强 
for (Advisor candidate : candidateAdvisors) ( 
if (candidate instanceof IntroductionAdvisor && ca 











nApply 


(candidate, clazz)) { 
eligibleAdvisors.add(candidate); 
} 
} 


boolean hasIntroductions = !eligibleAdvisors.isEmpty() 


for (Advisor candidate : candidateAdvisors) { 

// 引 介 增 强 已 经 处 理 

if (candidate instanceof IntroductionAdvisor) { 
continue; 



































} 
// 对 于 普通 bean 的 处 理 








if (canApply 


(candidate, clazz, hasIntroductions)) { 
eligibleAdvisors.add(candidate) ; 
} 
} 
return eligibleAdvisors; 


} 


public static boolean canApply(Advisor advisor, Class<?> target 
Class, boolean 
hasIntroductions) { 
if (advisor instanceof IntroductionAdvisor) { 
return ((IntroductionAdvisor) advisor).getClassFil 
ter().Matches (targetClass); 
jelse if (advisor instanceof PointcutAdvisor 


) { 
PointcutAdvisor pca = (PointcutAdvisor) advisor; 
return canApply 


(pca.getPointcut(), targetClass, hasIntroductions); 
yelse ( 
return true; 


} 








当前 我 们 分 析 的 是 对 于 UserService 是 否 适 用 于 





此 增强 方法 ， 那 么 当前 的 advisor 束 是 之 前 查找 出 来 
的 类 型 为 
BeanFactoryTransactionAttributeSourceAdvisor 的 
bean 实 例 ， 而 通过 类 的 层次 结构 我 们 又 知道 : 
BeanFactoryTransactionAttributeSourceAdvisor 间 接 
实现 了 PointcutAdvisor。 因 此 ， 在 canApply 函 数 中 
的 第 二 个 站 判断 时 就 会 通过 判断 ， 会 将 BeanFactory 
Transaction AttributeSourceAdvisor 中 的 getPointcut() 





方法 返回 值 作 为 参数 继续 调用 canApply 方 法 ， 而 
getPoint() 方 法 返回 的 是 
TransactionAttributeSourcePointcut 类 型 的 实例 。 对 
于 transactionAttribute Source 这 个 属性 大 家 还 有 印象 
H3? 这 是 在 解析 目 定义 标签 时 注入 进去 的 。 





private final TransactionAttributeSourcePointcut pointcut 


= new TransactionAttribute 
SourcePointcut() { 
QOverride 
protected TransactionAttributeSource getTransactionAtt 


ributeSource() { 
return transactionAttributeSource; 
} 
J}; 





那么 ， 使 用 ransactionAttributeSourcePointcut 类 
型 的 实例 作为 函数 参数 继续 跟踪 canApply。 





public static boolean canApply(Pointcut pc, Class<?> targetClas 
s, boolean hasIntroductions) { 
Assert.notNull(pc, "Pointcut must not be null"); 
if (!pc.getClassFilter().matches(targetClass)) { 
return false; 


j 


// 此 时 的 pc 表示 TransactionAttributeSourcePointcut 
//pc.getMethodMatcher() 返 回 的 正 是 自身 (this). 
MethodMatcher methodMatcher = pc.getMethodMatcher(); 


IntroductionAwareMethodMatcher introductionAwareMethod 
Matcher - null; 
if (methodMatcher instanceof IntroductionAwareMethodMa 


tcher) { 
introductionAwareMethodMatcher - (IntroductionAwar 
eMethodMatcher) methodMatcher; 
} 


Set«Class» classes = new HashSet<Class>(ClassUtils. Ge 
tAllInterfaces 
ForClassAsSet(targetClass)); 
classes.add(targetClass); 
//classes:[interface test.IITestBean, class test.TestB 
ean] 
for (Class<?> clazz : classes) { 
Method[] methods = clazz.getMethods(); 
for (Method method : methods) { 
if ((introductionAwareMethodMatcher != null && 
introductionAwareMethodMatcher.matches 
(method, targetClass, 
hasIntroductions)) || 
methodMatcher.matches 


(method, targetClass)) { 
return true; 
} 
} 
} 


return false; 





通过 上 面 函 数 大 致 可 以 理 清 大 体 脉络 ， 首 先 获 
Fx MISSIS BIER Be APE TRIAS AS Et EDO JJ, a 





过 程 中 又 对 类 中 的 方法 再 次 过 历 ， 一 旦 匹配 成 功 便 
认为 这 个 类 适用 于 当前 增强 颖 。 


到 这 里 我 们 不 茶会 有 疑问 ， 对 于 事务 的 配置 不 
仅仅 局 限于 在 函数 上 配置 ， 我 们 都 知道 ， 在 类 活 接 
口上 的 配置 可 以 延续 到 类 中 的 每 个 函数 ， 那 么 ， 如 














果 针 对 每 个 函数 进行 检测 ， 在 类 本 身上 配置 的 事务 
属性 岂 不 是 检测 不 到 了 吗 ? 带 着 这 个 疑问 ， 我 们 继 
续 探 求 matcher 方 法 。 





做 匹配 的 时 候 methodMatcher.matches(method,， 
targetClass) 会 使 用 TransactionAttributeSource 
Pointcut 类 的 matches 方 法 。 


public boolean matches(Method method, Class targetClass) { 
// 自 定义 标签 解析 时 注入 
TransactionAttributeSource tas = getTransactionAttribu 
teSource( ); 
return (tas -- null || tas.getTransactionAttribute 








(method, targetClass) !- null); 
} 





此 时 的 tas 表 示 
AnnotationTransactionAttributeSource 类 型 ， 而 
AnnotationTransactionAttribute Source 类 型 的 
getTransactionAttribute 方 法 如 下 : 





public TransactionAttribute getTransactionAttribute(Method 
method, Class<?> targetClass) { 


Object cacheKey - getCacheKey(method, targetClass); 
Object cached - this.attributeCache.get(cacheKey); 
if (cached !- null) ( 
if (cached == NULL TRANSACTION ATTRIBUTE) { 
return null; 


else ( 
return (TransactionAttribute) cached; 


} 
} 
else ( 
TransactionAttribute txAtt - computeTransactionAtt 
ribute 


(method, targetClass); 
// Put it in the cache. 
if (txAtt -- null) ( 
this.attributeCache.put(cacheKey, NULL TRANSAC 
TION ATTRIBUTE); 


else ( 
if (logger.isDebugEnabled()) { 
logger.debug("Adding transactional method 
" + method.getName() + "' with attribute: " + txAtt); 
} 


this.attributeCache.put(cacheKey, txAtt); 


} 
return txAtt; 





ARX], EgetTransactionAttribute K Zt rH 3F75 
有 找到 我 们 想 要 的 代码 ， 这 里 是 指 弟 规 的 一 贯 的 父 
Mo SAMA, WRI RIA RAEN 
话 ， 工 作 又 委托 给 了 computeTransaction Attribute ef 
数 ， 在 computeTransactionAttribute 函 数 中 终于 的 我 
们 看 到 了 事务 标签 的 提取 过 程 。 


3. 提取 事务 标签 





private TransactionAttribute computeTransactionAttribute(Method 
method, Class<?> targetClass) { 
// Don't allow no-public methods as required. 


if (allowPublicMethodsOnly() && !Modifier.isPublic(met 
hod.getModifiers())) { 
return null; 


} 

// Ignore CGLIB subclasses - introspect the actual use 
r class. 

Class<?> userClass = ClassUtils.getUserClass(targetCla 
SS); 








//method 代 表 接 口中 的 方法 ，specificMethod 代 表 实 现 类 中 的 方法 

Method specificMethod = ClassUtils.getMostSpecificMeth 
od(method, userClass); 

// If we are dealing with method with generic paramete 
rs, find the original 
method. 

specificMethod - BridgeMethodResolver.findBridgedMetho 
d(specificMethod); 











// 查 看 方法 中 是 否 存 在 事务 声明 
TransactionAttribute txAtt = findTransactionAttribute 


(specificMethod); 
if (txAtt !- null) ( 
return txAtt; 


j 


// 查 看 方法 所 在 类 中 是 否 存在 事务 声明 
txAtt = findTransactionAttribute 











(specificMethod.getDeclaringClass()); 
if (txAtt !- null) { 
return txAtt; 


} 
// 如 果 存 在 接口 ， 则 到 接口 中 去 寻找 
if (specificMethod != method) { 
// 查 找 接口 方法 
txAtt = findTransactionAttribute 


(method); 
if (txAtt !- null) ( 
return txAtt; 


l, 
// 到 接口 中 的 类 中 去 寻找 


return findTransactionAttribute 


(method.getDeclaringClass()); 


return null; 


j 





对 于 事务 属性 的 获取 规则 相信 大 家 都 已 经 很 清 





楚 ， 如 果 方 法 中 存在 事务 属性 ， 则 使 用 方法 上 的 属 
性 ， 人 否则 使 用 方法 所 在 的 类 上 的 属性 ， 如 采 方 法 所 
在 类 的 属性 上 还 是 没有 搜寻 到 对 应 的 事务 属性 ， 那 
么 再 搜寻 接口 中 的 方法 ， 再 没有 的 话 ， 最 后 尝试 搜 
寻 接 口 的 类 上 面 的 声明 。 对 于 函数 
computeTransactionAttribute 中 的 逻辑 与 我 们 所 认识 
的 规则 并 无 差别 ， 但 是 上 面 函 数 中 并 没有 真正 的 去 
做 搜寻 事务 属性 的 风 辑 ， 而 是 搭建 了 个 执行 框架 ， 
将 搜寻 事务 属性 的 任务 委托 给 了 
findTransactionAttribute 方 法 去 执行 。 











protected TransactionAttribute findTransactionAttribute(Method 
method) { 
return determineTransactionAttribute 


(method); 
} 


protected TransactionAttribute determineTransactionAttribute(An 
notatedElement ae) 

for (TransactionAnnotationParser annotationParser : th 
is.annotationParsers 


VA 

TransactionAttribute attr = annotationParser.parse 
Transaction Annotation (ae); 

if (attr != null) { 


return attr; 


j 


return null; 








this.annotationParsers7e 1E 4 All 38 
AnnotationTransactionAttributeSource 初 始 化 的 时 候 
初始 化 的 ， 其 中 的 值 被 加 入 了 
SpringTransactionAnnotationParser, tH Wize 4f] 
属性 获取 的 时 候 其 实 古 使 用 
SpringTransactionAnnotationParser 类 的 
parseTransactionAnnotation 方 法 进行 解析 的 。 











public TransactionAttribute parseTransactionAnnotation(Annotate 
dElement ae) { 
Transactional ann = AnnotationUtils.getAnnotation(ae, 
Transactional.class); 
if (ann != null) { 
return parseTransactionAnnotation 


else ( 
return null; 


J 








至 此 ， 我 们 终于 看 到 了 想 看 到 的 获取 注解 标记 
的 代码 。 首 先 会 判断 当前 的 类 是 否 含有 
Transactional 注 解 ， 这 是 事务 属性 的 基础 ， 当 然 如 





果 有 的 话 会 继续 调用 parseTransactionAnnotation 方 
法 解析 详细 的 属性 。 





public TransactionAttribute parseTransactionAnnotation(Transact 
ional ann) ( 

RuleBasedTransactionAttribute rbta - new RuleBasedTran 
sactionAttribute(); 

// 解 析 propagation 

rbta.setPropagationBehavior(ann.propagation().value()) 





// 解 析 isolation 
rbta.setIsolationLevel(ann.isolation().value()); 
// 解 析 timeout 
rbta.setTimeout(ann.timeout()); 
/ /fitrreadOnly 
rbta.setReadOnly(ann.readOnly()); 
// 解 析 value 
rbta.setQualifier(ann.value()); 
ArrayList«RollbackRuleAttribute» rollBackRules - new A 
rrayList«RollbackRule 
Attribute»(); 
// 解 析 rollbackFor 
Class[] rbf = ann.rollbackFor(); 
for (Class rbRule : rbf) { 
RollbackRuleAttribute rule - new RollbackRuleAttri 
bute(rbRule); 
rollBackRules.add(rule); 











} 
// 解 析 rollbackForClassName 
String[] rbfc = ann.rollbackForClassName(); 
for (String rbRule : rbfc) { 
RollbackRuleAttribute rule - new RollbackRuleAttri 
bute(rbRule); 
rollBackRules.add(rule); 


} 
// 解 析 noRollbackFor 
Class[] nrbf = ann.noRollbackFor(); 
for (Class rbRule : nrbf) { 
NoRollbackRuleAttribute rule - new NoRollbackRuleA 
ttribute(rbRule); 
rollBackRules.add(rule); 





//fi&jrnoRollbackForClassName 





String[] nrbfc = ann.noRollbackForClassName(); 
for (String rbRule : nrbfc) { 
NoRollbackRuleAttribute rule - new NoRollbackRuleA 
ttribute(rbRule); 
rollBackRules.add(rule); 


} 
rbta.getRollbackRules().addAll(rollBackRules); 
return rbta; 








上 面 方法 中 实现 了 对 对 应 类 或 者 方法 的 事务 属 











性 解 机 ， 你 会 在 这 个 关中 看 到 任何 你 利用 或 者 不 种 
用 的 属性 提取 。 


至 此 ， 我 们 终于 完成 了 事务 标签 的 解析 。 我 们 
是 不 是 分 析 的 太 远 了 ， 似 乎 已 经 筷 了 从 哪里 开始 
了 。 再 回顾 一 下 ， 我 们 的 现在 的 任务 是 找 出 某 个 增 
强 髓 是 否 适 合 于 对 应 的 类 ， 而 是 个 匹配 的 关键 则 在 
于 是 个 从 指定 的 类 或 类 中 的 方法 中 找到 对 应 的 事务 
属性 ， 现 在 ， 我 们 以 UserServiceImp] 为 例 ， 已 经 在 
它 的 接口 UserService 中 找到 了 事务 属性 ， 所 以 ， 它 
SR eee eee ll 
(ffi s 


全 此 ， 事 务 功能 的 初始 化 工作 便 结 束 了 ， 当 判 
灯 茶 个 bean 适 用 于 事务 增强 时 ， 也 融 是 适用 于 增强 
a BeanFactory TransactionAttributeSourceAdvisor; 
没 错 ， 还 是 这 个 类 ， 所 以 说 ， 在 目 定 义 标 签 解 析 
时 ， 注 入 的 类 成 为 了 整个 事务 功能 的 基础 。 
































BeanFactoryTransactionAttributeSourceAdvisor 
作为 Advisor 的 实现 类 ， 目 然 要 遵从 Advisor 的 处 理 
方式 ， 当 代理 被 调用 时 会 调用 这 个 类 的 增强 方法 ， 
也 残 是 此 bean 的 Advise， 又 因为 在 解析 事务 定义 标 
签 时 我 们 把 TransactionInterceptor 类 型 的 bean 注 入 到 
J BeanFactory TransactionAttributeSourceAdvisor 
tH, TA, fe dal A S55 HE gh RIS oem A BESSY A 
"51417 TransactionInterceptorit jy ign, IAI, that 
是 在 TransactionInterceptor 类 中 的 invoke 方 法 中 完成 
SER SS PEIE 











10.3 ”事务 增强 器 


TransactionInterceptor 文 撑 看 整个 事务 功能 的 架 
构 ， 逻 辑 还 是 相对 复杂 的 ， 那 么 现在 我 们 切入 正题 
来 分 析 此 拦截 器 是 如 何 实 现 事 务 特性 的 。 
TransactionInterceptor 类 继承 上 自 MethodInterceptor,， 
所 以 调用 该 类 是 从 其 invoke 方 法 开始 的 ， 首 先 预览 
下 这 个 方法 : 














public Object invoke(final MethodInvocation invocation) throws 
Throwable { 
Class<?> targetClass = (invocation.getThis() != null ? 
AopUtils.getTargetClass 
(invocation.getThis()) : null); 











// 获 取 对 应 事务 属性 
final TransactionAttribute txAttr = 
getTransactionAttributeSource().getTransaction 





Attribute 


(invocation. getMethod(), targetClass); 
// 获 取 beanFactory 中 的 transactionManager 

final PlatformTransactionManager tm = determineTransac 
tionManager(txAttr); 
// 构 造 方法 唯一 标识 (类 ,方法 ， 如 service.UserServiceImpl.save) 

final String joinpointIdentification = methodIdentific 
ation (invocation. 
getMethod(), targetClass); 
































H 


// 声 明 式 事务 处 到 
if (txAttr -- null || !(tm instanceof CallbackPreferri 
ngPlatformTransaction 
Manager)) ( 





//&|&& TransactionInfo 
TransactionInfo txInfo = createTransactionIfNecess 
ary 


(tm, txAttr, joinpoint Identification); 
Object retVal = null; 
try { 
// 执 行 被 增强 方法 
retVal = invocation.proceed(); 











} 
catch (Throwable ex) { 


// 异 常 回 深 
completeTransactionAfterThrowing(txInfo, ex); 








throw ex; 
} 
finally { 
// 清 除 信息 
cleanupTransactionInfo(txInfo); 
} 
// 提 交 事 务 





commitTransactionAfterReturning 









































(txInfo); 
return retVal; 
} 
else ( 
// 编 程式 事务 处 理 
try { 


Object result - ((CallbackPreferringPlatformTr 


ansactionManager) tm). execute(txAttr, 
new TransactionCallback<Object>() { 


sactionStatus status) { 


reTransactionInfo(tm, 


txAttr, joinpointIdentification, 


); 


{ 


will lead to a rollback. 
imeException) { 


ption) ex; 


eHolderException(ex); 


ue: will lead to a commit. 


lder(ex); 


nfo); 


J): 


// Check result: 


to rethrow. 


public Object doInTransaction(Tran 
TransactionInfo txInfo = prepa 


status); 
try { 


return invocation.proceed( 


catch (Throwable ex) { 


if (txAttr.rollbackOn(ex) ) 
// A RuntimeException: 
if (ex instanceof Runt 


throw (RuntimeExce 


} 
else { 
throw new Throwabl 
} 
} 
else { 
// A normal return val 
return new ThrowableHo 
} 


finally { 


cleanupTransactionIinfo(txI 


It might indicate a Throwable 


if (result instanceof ThrowableHolder) { 
throw ((ThrowableHolder) result).getThrowa 


ble(); 


} 
else ( 
return result; 


} 
catch (ThrowableHolderException ex) { 
throw ex.getCause(); 





从 上 面 的 函数 中 ， 我 们 尝试 整理 下 事务 处 理 的 
脉络 ， 在 Spring 中 文 持 两 种 事务 处 理 的 方式 ， 分 别 
是 声明 式 事务 处 理 与 编程 式 事务 处 理 ， 两 者 相对 于 
开发 人 员 来 讲 兰 别 很 大 ， 但 是 对 于 Spring 中 的 实现 
来 讲 ， 大 同 小 异 。 在 invoke 中 我 们 也 可 以 看 到 这 两 





种 方式 的 实现 。 考 虑 到 对 事务 的 应 用 比 声明 式 的 事 
务 处 理 使 用 起 来 方便 ， 也 相对 流行 些 ， 我 们 就 以 此 
种 方式 进行 分 机 。 对 于 声明 却 的 事务 处 理 主要 有 以 


下 几 个 步骤 。 
1. 获取 事务 的 属性 。 


对 于 事务 处 理 来 说 ， 最 基础 或 者 说 最 首要 的 工 
作 便 是 获取 事务 属性 了 ， 这 是 文 撑 整 个 事务 功能 的 
基石 ， 如 果 没 有 事务 属性 ， 其 他 功能 也 无 从 谈 起 ， 
在 分 析 事 务 准 备 阶段 时 我 们 已 经 分 析 了 事务 属性 拓 
取 的 功能 ， 大 家 应 该 有 所 了 解 。 











2. 加 载 配 置 中 配置 的 TransactionManager。 
3. 不 同 的 事务 处 理 方 式 使 用 不 同 的 逻辑 。 


对 于 声明 式 事务 的 处 理 与 编程 式 事务 的 处 理 ， 
第 一 点 区 别 在 于 事务 属性 上 ， 因 为 编程 式 的 事务 处 
理 是 不 需要 有 事务 属性 的 ， 第 二 点 区 别 就 是 在 
TransactionManager 上 ，CallbackPreferring 
PlatformTransactionManager 实 现 
PlatformTransactionManager 接 口 ， 暴 露出 一 个 方法 
用 于 执行 事务 处 理 中 的 回调 。 所 以 ， 这 两 种 方式 都 
可 以 用 作 事 务 处 理 方式 的 判断 。 


4. 在 目标 方法 执行 前 获取 事务 并 收集 事务 信 
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TransactionInfo 与 TransactionAttribute 并 不 相同 ， 
TransactionInfo 中 包含 TransactionAttribute 人 信息， 但 
是 ， 除 了 TransactionAttribute 外 还 有 其 他 事务 信 
妃 ， 例 如 PlatformTransactionManager 以 及 
TransactionStatus 相 关 信 息 。 


5. 执行 目标 方法 。 


6. —HHJ E, SEE AH. 





并 不 是 所 有 异常 ，Spring 都 会 将 其 回 深 ， 默 认 
只 对 RuntimeException 回 深 。 


7. 提交 事务 前 的 事务 信息 清除 。 
8. 提交 事务 。 


上 面 的 步骤 分 析 间 在 让 大 家 对 事务 功能 与 步 纪 
有 个 大 致 的 了 解 ， 具 体 的 功能 还 需要 详细 地 分 析 。 





10.3.1 创建 事务 


我 们 先 分 析 事 务 创建 的 过 程 。 





protected TransactionInfo createTransactionIfNecessary( 
PlatformTransactionManager tm, TransactionAttribut 
e txAttr, final String joinpointIdentification) { 


// If no name specified, apply method identification a 
S transaction name. 
// 如 果 没 有 名 称 指定 则 使 用 方法 唯一 标识 ， 并 使 用 DelegatingTransac 
tionAttribute 封 装 txAttr 
if (txAttr !- null && txAttr.getName() == null) { 
txAttr - new DelegatingTransactionAttribute(txAttr 











]-1 
QOverride 
public String getName() { 
return joinpointIdentification; 
} 


H 
} 


TransactionStatus status = null; 
if (txAttr != null) { 


if (tm != null) { 
//ikWTransactionStatus 
status - tm.getTransaction 


(txAttr); 

} 

else ( 

if (logger.isDebugEnabled()) (1 
logger.debug("Skipping transactional joinp 
oint [" + joinpoint 
Identification + 
"] because no transaction manager 

has been configured"); 


j 


} 
// 根 据 指定 的 属性 与 status 准 备 一 个 TransactionInfo 
return prepareTransactionInfo 








(tm, txAttr, joinpointIdentification, status); 





Xf F createTransactionIfNecessar eh Zt E E 4l 
这 样 几 件 事情 。 


1. 使 用 DelegatingTransactionAttribute 封 装 传 入 
的 TransactionAttribute 实 例 。 


对 于 传 入 的 TransactionAttribute 类 型 的 参数 
tXAttr， 当 前 的 实际 类 型 是 RuleBasedTransaction 
Attribute， 是 由 获取 事务 属性 时 生成 ， 主 要 用 于 数 
据 承 载 ， 而 这 里 之 所 以 使 用 Delegating 
TransactionAttribute 进 行 封 装 ， 当 然 是 提供 了 更 多 
的 功能 。 








2. 获取 事务 。 


事务 处 理 当 然 是 以 事务 为 核心 ， 那 么 获取 事务 
就 是 最 重要 的 事情 。 


3. 构建 事务 信息 。 


根据 之 前 几 个 步骤 获取 的 信息 构建 
TransactionInfo 并 返 E [n] 。 


我 们 分 别 对 以 上 步骤 进行 详细 的 解析 。 
1. 获取 事务 


Spring 中 使 用 getTransaction 来 处 理事 务 的 准备 
工作 ， 包 括 事务 获取 以 及 信息 的 构建 。 





public final TransactionStatus getTransaction(TransactionDefini 
tion definition) throws TransactionException { 
Object transaction = doGetTransaction 


(); 


// Cache debug flag to avoid repeated checks. 
boolean debugEnabled = logger .isDebugEnabled(); 


if (definition == null) { 
// Use defaults if no transaction definition given 


definition = new DefaultTransactionDefinition(); 





} 
// 判 断 当前 线程 是 否 存在 事务 ， 判 读 依 据 为 当前 线程 记录 的 连接 不 为 空 且 连接 中 (conn 
ectionHolder ) 中 的 








//transactionActive 属 性 不 为 空 
if (isExistingTransaction(transaction)) { 
// 当 前 线程 已 经 存在 事务 
return handleExistingTransaction 








(definition, transaction, debugEnabled); 


Jj 


// 事 务 超 时 设置 验证 
if (definition.getTimeout() < TransactionDefinition.TI 
MEOUT DEFAULT) ( 
throw new InvalidTimeoutException("Invalid transac 
tion timeout", definition.getTimeout()); 














} 

// 如 果 当 前 线程 不 存在 事务 ， 但 是 propagationBehavior 却 被 声明 为 PR 
OPAGATION. MANDATORY 7l 

// 出 异常 

if (definition.getPropagationBehavior() == Transaction 
Definition. PROPAGATION  MANDATORY) { 

throw new IllegalTransactionStateException( 
"No existing transaction found for transac 





tion marked with 
propagation 'mandatory'"); 


jelse if (definition.getPropagationBehavior() -- Trans 
actionDefinition. 
PROPAGATION REQUIRED || 
definition.getPropagationBehavior() -- Transac 
tionDefinition. PROPAGATION REQUIRES NEW || 
definition.getPropagationBehavior() -- Transaction 


Definition.PROPAGATION NESTED) { 
//PROPAGATION REQUIRED. PROPAGATION REQUIRES NEW. P 











// 新 建 事务 


SuspendedResourcesHolder suspendedResources = susp 
end(null); 
if (debugEnabled) { 
logger.debug("Creating new transaction with na 
me [" + definition. 
getName() + "]: " + definition); 
} 


try { 
boolean newSynchronization = (getTransactionSy 


nchronization() !- 


SYNCHRONIZATION NEVER); 
DefaultTransactionStatus status - newTransacti 
onStatus( 
definition, transaction, true, newSync 
hronization, debugEnabled, 
suspendedResources); 
/* 
* 构造 transaction, 包 括 设置 ConnectionHolder、 隔 离 
级 别 、timout 
* 如 果 是 新 连接 ， 绑 定 到 当前 线程 
T£ 
doBegin 








(transaction, definition); 
// 新 同步 事务 的 设置 ， 针 对 于 当前 线程 的 设置 


prepareSynchronization 





(status, definition); 

return status; 

} 

catch (RuntimeException ex) { 
resume(null, suspendedResources); 
throw ex; 

} 

catch (Error err) { 
resume(null, suspendedResources); 
throw err; 

} 

} 


else { 

// Create "empty" transaction: no actual transacti 
on, but potentially 
synchronization. 

boolean newSynchronization - (getTransactionSynchr 
onization() -- 
SYNCHRONIZATION ALWAYS); 

return prepareTransactionStatus(definition, null, 
true, newSynchronization, 
debugEnabled, null); 


j 





当然 ， 在 Spring 中 每 个 复杂 的 功能 实现 ， 并 不 
是 一 次 完成 的 ， 而 征 会 通过 入 口 函 数 进行 一 个 框 以 
的 搭建 ， 初 步 构 建 完整 的 多 辑 ， 而 将 实现 细 记 分摊 
给 不 同 的 函数 。 那 么 ， 让 我 们 看 看 事务 的 准备 工作 
都 包括 哪些 。 


1. 获取 事务 。 


创建 对 应 的 事务 实例 ， 这 里 使 用 的 是 
DataSourceTransactionManager 中 的 doGetTransaction 
方法 ， 创 建 基 于 JDBC 的 事务 实例 。 如 果 当 前 线程 
中 存在 关于 dataSource 的 连接 ， 那 么 直接 使 用 。 这 
里 有 一 个 对 保存 点 的 设置 ， 是 否 开 局 允许 保存 点 取 
决 于 是 否 设 置 了 允许 艇 入 式 事务 。 














protected Object doGetTransaction() { 
DataSourceTransactionObject txObject = new DataSourceT 

ransactionObject(); 
txObject.setSavepointAllowed(isNestedTransactionAllowe 


d()); 








// 如 果 当 前 线程 已 经 记录 数据 库 连 接 则 使 用 原 有 连 
ConnectionHolder conHolder = 
(ConnectionHolder) TransactionSynchronizationManag 











er.getResource(this. 
dataSource); 
//false 表 示 非 新 创建 连接 
txObject.setConnectionHolder(conHolder, false); 
return txObject; 














2. WAAGE ECESKS. NYP RBS 


的 处 理 。 
3. 事务 超时 设置 验证 。 
4. 事务 propagationBehavior 属 性 的 设置 验证 。 


5. 构建 DefaultTransactionStatus。 





6. 完善 transaction， 包 括 设置 
ConnectionHolder、 隔 离 级 别 、timeout， 如 果 是 新 
连接 ， 则 绑 定 到 当前 线程 。 


对 于 一 些 隔 离 级 别 、timeout 等 功能 的 设置 并 不 
是 由 Spring 来 完成 鸭 ， 而 是 委托 给 底层 的 数据 库 连 
接 去 做 的 ， 而 对 于 数据 库 连 接 的 设置 束 是 在 
doBeginrK Zi F Ah SER « 





fe 
* 构造 transaction, 包括 设置 ConnectionHolder、 隔 离 级 别 、timeout 
* 如 果 是 新 连接 ， 绑 定 到 当前 线程 
a7 








@Override 
protected void doBegin(Object transaction, TransactionDefinitio 
n definition) { 
DataSourceTransactionObject txObject = (DataSourceTran 
sactionObject) transaction; 
Connection con = null; 


try { 
if (txObject.getConnectionHolder() == null || 
txObject.getConnectionHolder().isSynchroni 
zedwithTransaction()) ( 
Connection newCon - this.dataSource.getConnect 
ion(); 


if (logger.isDebugEnabled()) { 
logger .debug( "Acquired Connection [" + new 
Con + "] for JDBC transaction"); 
} 
txObject.setConnectionHolder(new ConnectionHol 
der(newCon), true); 


l 


txObject.getConnectionHolder().setSynchronizedWith 
Transaction(true); 
con = txObject.getConnectionHolder().getConnection 


(); 


// 设 置 隔离 级 别 

Integer previousIsolationLevel = DataSourceUtils.p 
repareConnection 
ForTransaction 


(con, definition); 
txObject.setPreviousIsolationLevel(previousIsolati 
onLevel); 





// 更 改 自 动 提交 设置 ， 由 Spring 控制 提交 
if (con.getAutoCommit()) 1 
txObject.setMustRestoreAutoCommit(true); 
if (logger.isDebugEnabled()) { 
logger .debug( "Switching JDBC Connection [" 
+ con + "] to manual commit"); 


j 


con.setAutoCommit (false); 














Í 
// 设 置 判 断 当 前 线程 是 否 存在 事务 的 依据 


txObject.getConnectionHolder().setTransactionActiv 





e(true); 


int timeout - determineTimeout(definition); 
if (timeout !- TransactionDefinition.TIMEOUT DEFAU 
LT) { 
txObject.getConnectionHolder().setTimeoutInSec 
onds(timeout); 


j 


// Bind the session holder to the thread. 
if (txObject.isNewConnectionHolder()) { 
// 将 当前 获取 到 的 连接 绑 定 到 当前 线程 








TransactionSynchronizationManager.bindResource 
(getDataSource(), 
txObject.getConnectionHolder()); 
} 


} 


catch (Exception ex) { 
DataSourceUtils.releaseConnection(con, this.dataSo 
urce); 
throw new CannotCreateTransactionException("Could 
not open JDBC Connection 
for transaction", ex); 


j 
j 





可 以 说 事务 是 从 这 个 函数 开始 的 ， 因 为 在 这 个 





图 数 中 已 经 开始 答 试 了 对 数据 库 连 接 的 获取 ， 当 
然 ， 在 获取 数据 库 连 接 的 同时 ， 一 些 必要 的 设置 也 


是 需要 同步 设置 的 。 








1l. SARE. 


当然 并 不 是 每 次 都 会 获取 新 的 连接 ， 如 果 当 前 
线程 中 的 connectionHolder 已 经 存在 ， 则 没有 必要 再 
次 获取 ， 或 者 ， 对 于 事务 同步 表示 设置 为 tue 的 需 
要 重新 获取 连接 。 


2， 设 置 隔离 级 别 以 及 只 读 标 识 。 


你 是 个 有 过 这 样 的 错觉 ?事务 中 的 只 读 配 置 是 
Spring 中 做 了 一 些 处 理 呢 ? Spring 中 确实 是 针对 只 














读 操作 做 了 一 些 处 理 ， 但 是 核心 的 实现 是 设置 
connection 上 的 readOnly 属 性 。 同 样 ， 对 于 隔离 级 别 
的 控制 也 是 交 由 connection 去 控制 的 。 

3. 更 改 默认 的 提交 设置 。 


如 果 事 务 属性 是 自动 提交 ， 那 么 需要 改变 这 种 
设置 ， 而 将 提交 操作 委托 给 Spring 来 处 理 。 


4. 设置 标志 位 ， 标 识 当前 连接 已 经 个 事 务 油 
活 。 


5. 设置 过 期 时 间 。 











6. 将 connectionHolder 比 定 到 当前 线程 。 


设置 隔离 级 别 的 
prepareConnectionForTransactionPK Zi H F $4 Ti XT JE 
层 数 据 库 连接 的 设置 ， 当 然 ， 只 是 包含 只 恋 标 识 和 
隔离 级 别 的 设置 。 由 于 强大 的 日 志 及 异 负 处 理 ， 显 
得 函数 代码 量 比较 大 ， 但 是 单 从 业务 角度 去 看 ， 关 
键 代 码 其 实 是 不 多 的 。 











public static Integer prepareConnectionForTransaction(Connectio 
n con, Transaction 
Definition definition) 

throws SQLException ( 


Assert.notNull(con, "No Connection specified"); 


// 设 置 数据 连接 的 只 读 标 识 
if (definition !- null && definition.isReadOnly()) { 
try { 
if (logger.isDebugEnabled()) { 
logger.debug("Setting JDBC Connection [" + 
con * "] read-only"); 





con.setReadOnly(true); 


catch (SQLException ex) { 
Throwable exToCheck - ex; 
while (exToCheck !- null) ( 
if (exToCheck.getClass().getSimpleName().c 
ontains("Timeout")) ( 
// Assume it's a connection timeout th 
at would otherwise get lost: e.g. from JDBC 4.0 
throw ex; 


j 


exToCheck = exToCheck.getCause( ); 
} 
logger.debug("Could not set JDBC Connection re 
ad-only", ex); 


catch (RuntimeException ex) { 
Throwable exToCheck = ex; 
while (exToCheck !- null) { 
if (exToCheck.getClass().getSimpleName().c 
ontains("Timeout")) ( 
throw ex; 


exToCheck = exToCheck.getCause( ); 


logger.debug("Could not set JDBC Connection re 
ad-only", ex); 
} 
} 


// 设 置 数 据 库 连接 的 隔离 级 别 
Integer previousIsolationLevel = null; 
if (definition !- null && definition.getIsolationLevel 
() != Transaction 
Definition.ISOLATION DEFAULT) { 
if (logger.isDebugEnabled()) (1 
logger.debug("Changing isolation level of JDBC 





Connection [" + con + "] to " + 
definition.getIsolationLevel()); 


j 


int currentIsolation - con.getTransactionIsolation 


(0; 
el()) ( 


if (currentIsolation !- definition.getIsolationLev 


previousIsolationLevel = currentIsolation; 
con.setTransactionIsolation(definition.getIsol 
ationLevel()); 
} 
} 


return previousIsolationLevel; 








7. 将 事务 信息 记录 在 当前 线程 中 。 





protected void prepareSynchronization(DefaultTransactionStatus 
status, Transaction 
Definition definition) { 
if (status.isNewSynchronization()) { 
TransactionSynchronizationManager.setActualTransac 
tionActive(status. 
hasTransaction()); 
TransactionSynchronizationManager.setCurrentTransa 
ctionlIsolationLevel( 


(definition.getIsolationLevel() !- Transac 
tionDefinition.ISOLATION 
DEFAULT) ? 
definition.getIsolationLevel() : n 
ull); 


TransactionSynchronizationManager .setCurrentTransa 
ctionReadOnly (definition. isReadOnly()); 

TransactionSynchronizationManager.setCurrentTransa 
ctionName(definition. 
getName()); 

TransactionSynchronizationManager.initSynchronizat 
ion(); 


J 


处 理 已 经 存在 的 事务 


之 六 讲述 了 普通 事务 建立 的 过 程 ， 但 是 Spring 
中 文 持 多 种 事务 的 传播 规则 ， 比 如 
PROPAGATION_NESTED、 

PROPAGATION REQUIRES NEW 等 ， 这 些 都 是 在 
己 经 存在 事务 的 基础 上 进行 进一步 的 处 理 ， 那 么 ， 
对 于 已 经 存在 的 事务 ， 准 备 操作 是 如 何 进行 的 呢 ? 











private TransactionStatus handleExistingTransaction( 
TransactionDefinition definition, Object transacti 
on, boolean debugEnabled) 
throws TransactionException { 


if (definition.getPropagationBehavior() -- Transaction 
Definition.PROPAGATION NEVER) { 
throw new IllegalTransactionStateException( 
"Existing transaction found for transactio 
n marked with propagation 'never'"); 


if (definition.getPropagationBehavior() -- Transaction 
Definition.PROPAGATION NOT SUPPORTED) ( 
if (debugEnabled) { 
logger.debug("Suspending current transaction") 


j 


Object suspendedResources - suspend(transaction); 
boolean newSynchronization - (getTransactionSynchr 
onization() == SYNCHRONIZATION ALWAYS); 
return prepareTransactionStatus( 
definition, null, false, newSynchronizatio 
n, debugEnabled, 
suspendedResources); 


if (definition.getPropagationBehavior() -- Transaction 
Definition.PROPAGATION REQUIRES NEW) { 
if (debugEnabled) { 
logger.debug("Suspending current transaction, 
creating new transaction 
with name [" + 
definition.getName() + "]|"); 








} 
// 新 事务 的 建立 
SuspendedResourcesHolder suspendedResources = susp 
end(transaction); 
try { 
boolean newSynchronization - (getTransactionSy 
nchronization() !- 
SYNCHRONIZATION NEVER); 
DefaultTransactionStatus status - newTransacti 
onStatus( 
definition, transaction, true, newSync 
hronization, debugEnabled, suspendedResources); 
doBegin(transaction, definition); 
prepareSynchronization(status, definition); 
return status; 
} 
catch (RuntimeException beginEx) { 
resumeAfterBeginException(transaction, suspend 
edResources, beginEx); 
throw beginEx; 
} 
catch (Error beginErr) { 
resumeAfterBeginException(transaction, suspend 
edResources, beginErr); 
throw beginErr; 


j 


} 
/ RAKES BS ABE 
if (definition.getPropagationBehavior() -- Transaction 
Definition.PROPAGATION_ NESTED) { 
if (!isNestedTransactionAllowed()) { 
throw new NestedTransactionNotSupportedExcepti 























on( 

"Transaction manager does not allow ne 
sted transactions by 
default - " + 

"specify 'nestedTransactionAllowed' pr 
operty with value 'true'"); 


} 
if (debugEnabled) { 
logger.debug("Creating nested transaction with 
name [" + definition. 
getName() + "]"); 
} 
if (useSavepointForNestedTransaction()) { 
// 如 果 没 有 可 以 使 用 保存 点 的 方式 控制 事务 回 滚 ， 那 么 在 嵌入 
式 事 务 的 建立 初始 建立 保存 点 
DefaultTransactionStatus status = 
prepareTransactionStatus(definition, t 
ransaction, false, false, debugEnabled, null); 
status.createAndHoldSavepoint(); 
return status; 
jelse ( 
// 有 些 情况 是 不 能 使 用 保存 点 操作 ， 比 如 JTA， 那 么 建立 新 事务 
boolean newSynchronization = (getTransactionSy 
nchronization() !- 
SYNCHRONIZATION NEVER); 
DefaultTransactionStatus status - newTransacti 









































onStatus( 
definition, transaction, true, newSync 
hronization, debugEnabled, 


null); 
doBegin(transaction, definition); 
prepareSynchronization(status, definition); 
return status; 
j 
} 
if (debugEnabled) { 
logger.debug("Participating in existing transactio 
n"); 


if (isValidateExistingTransaction()) { 
if (definition.getIsolationLevel() != TransactionD 
efinition.PROPAGATION  REQUIRES NEW) { 
Integer currentIsolationLevel = TransactionSyn 
chronizationManager. 
getCurrentTransactionlIsolationLevel(); 
if (currentIsolationLevel -- null || currentis 
olationLevel !- 
definition.getIsolationLevel()) { 
Constants isoConstants = DefaultTransactio 
nDefinition.constants; 


throw new IllegalTransactionStateException 
("Participating transaction 
with definition [" + 
definition + "] specifies isolatio 
n level which is 
incompatible with existing transaction: " + 
(currentIsolationLevel !- null ? 
isoConstants.toCode(curren 
tIsolationLevel, 
DefaultTransactionDefinition.PREFIX ISOLATION) : 
"(unknown)")); 
} 


} 
if (!definition.isReadOnly()) { 
if (TransactionSynchronizationManager.isCurren 
tTransactionReadOnly()) { 
throw new IllegalTransactionStateException 
("Participating transaction 
with definition [" + 
definition + "] is not marked as r 
ead-only but existing 
transaction is"); 
} 
} 
} 
boolean newSynchronization = (getTransactionSynchroniz 
ation() !- SYNCHRONIZATION NEVER); 
return prepareTransactionStatus(definition, transactio 
n, false, newSynchronization, debugEnabled, null); 





对 于 已 经 存在 事务 的 处 理 过 程 中 ， 我 们 看 到 了 





很 多 熟悉 的 操作 ， 但 是 ， 也 有 些 不 同 的 地 方 ， 函 数 
中 对 已 经 存在 的 事务 处 理 考 虑 两 种 情况 。 


。PROPAGATION_REQUIRES_NEW 表 示 当 前 方 
法 必须 在 它 目 己 的 事务 里 运行 ， 一 个 新 的 事务 
将 被 局 动 ， 而 如 琳 有 一 个 事务 正在 运行 的 话 ， 











则 在 这 个 方法 运行 期 间 被 挂 起 。 而 Spring 中 对 于 
此 种 传播 方式 的 处 理 与 新 事务 建立 最 大 的 不 同 
点 在 于 使 用 suspend 方 法 将 原 事务 挂 起 。 将 信息 
挂 起 的 目的 当然 是 为 了 在 当前 事务 执行 完毕 后 
在 将 原 事务 还 原 。 
PROPAGATION_NESTED 表 示 如 果 当 前 正 有 一 
个 事务 在 运行 中 ， 则 该 方法 应 该 运行 在 一 个 髓 
套 的 事务 中 ， 被 舱 套 的 事务 可 以 独立 于 封装 事 
务 进 行 提交 或 者 回 深 ， 如 果 封 装 事 务 不 存在 ， 
4T JS PROPAGATION REQUIRES NEW. 
WFAA SHS EE, Spring Ee eT Wi 
种 方式 的 处 理 。 

o Spring 中 允许 磐 入 事务 的 时 候 ， 则 首选 设置 
保存 点 的 方式 作为 异常 处 理 的 回 深 。 

o 对 于 其 他 方式 ， 比 如 JTA 无 法 使 用 保存 点 的 
方式 ， 那 么 处 理 方 式 与 PROPAGATION _- 
REQUIRES_NEW 相 同 ， 而 一 旦 出 现 异 常 ， 
pucr 


对 于 挂 起 操作 的 主要 目的 是 记录 原 有 事务 的 状 












































态 ， 以 便于 后 续 操 作对 事务 的 恢复 : 





protected final SuspendedResourcesHolder suspend(Object transac 
tion) throws Transaction 

Exception ( 

if (TransactionSynchronizationManager.isSynchronizatio 
nActive()) { 


List<TransactionSynchronization> suspendedSynchron 
izations - doSuspend 
Synchronization(); 


try { 
Object suspendedResources - null; 
if (transaction !- null) ( 
suspendedResources - doSuspend(transaction 
); 
} 


String name = TransactionSynchronizationManage 
r. GetCurrent Transaction Name(); 

TransactionSynchronizationManager.setCurrentTr 
ansactionName (null); 


boolean readOnly - TransactionSynchronizationM 
anager.isCurrentTransaction ReadOnly(); 

TransactionSynchronizationManager.setCurrentTr 
ansactionReadOnly(false); 


Integer isolationLevel - TransactionSynchroniz 
ationManager.getCurrent TransactionIsolationLevel(); 

TransactionSynchronizationManager.setCurrentTr 
ansactionIsolation Level(null); 


boolean wasActive - TransactionSynchronization 
Manager.isActual 
TransactionActive(); 
TransactionSynchronizationManager.setActualTra 
nsactionActive(false); 


return new SuspendedResourcesHolder( 
suspendedResources, suspendedSynchroni 
zations, name, readOnly, isolationLevel, wasActive); 
} 
catch (RuntimeException ex) { 
// doSuspend failed - original transaction is 
still active... 
doResumeSynchronization(suspendedSynchronizati 


ons); 
throw ex; 
3 
catch (Error err) { 
doResumeSynchronization(suspendedSynchronizati 
ons); 


throw err; 


J 


} 
else if (transaction != null) { 
Object suspendedResources = doSuspend(transaction) 
return new SuspendedResourcesHolder(suspendedResou 
rces); 
else ( 
return null; 
} 
} 





3. 准备 事务 信息 





当 已 经 建立 事务 连接 并 完成 了 事务 信息 的 提取 
后 ， 我 们 需要 将 所 有 的 事务 信息 统一 记录 在 
TransactionInfo 类 型 的 实例 中 ， 这 个 实例 包含 了 日 
标 方法 开始 前 的 所 有 状态 信息 ， 一 旦 事务 执行 失 
败 ，Spring 会 通过 TransactionInfo 类 型 的 实例 中 的 信 
ERHI ERF ERLE. 








protected TransactionInfo prepareTransactionInfo(PlatformTransa 
ctionManager tm, 

TransactionAttribute txAttr, String joinpointIdent 
ification, Transaction Status status) { 


TransactionInfo txInfo - new TransactionInfo(tm, txAtt 
r, joinpointIdentification); 
if (txAttr !- null) ( 
// We need a transaction for this method 
if (logger.isTraceEnabled()) { 
logger.trace("Getting transaction for [" + txI 
nfo.getJoinpoint 
Identification() + "]"); 


// 记 录 事 务 状 态 
txlInfo.newTransactionStatus(status); 





else ( 
if (logger.isTraceEnabled()) 
logger.trace("Don't need to create transaction 
for [" * joinpoint 
Identification + 
"]: This method isn't transactional.") 


, 


} 
txInfo.bindToThread(); 
return txInfo; 





10.3.2. [HE AB FE 


«BU 已 经 完成 了 目标 方法 运行 前 的 事务 准备 工 
作 ， 而 这 些 准 备 工 作 最 大 的 目的 无 非 是 对 于 程序 没 
有 按照 我 们 期 待 的 那样 进行 ， 也 就 是 出 现 特定 的 错 
误 ， 那 么 ， 当 出 现 错误 的 时 候 ，Spring 是 怎么 对 数 
据 进 行 恢 复 的 呢 ? 








protected void completeTransactionAfterThrowing(TransactionInfo 
txInfo, Throwable ex) 


// 当 抛 出 异常 时 首先 判断 当前 是 否 存 在 事务 ， 这 是 基础 依据 














if (txInfo != null && txInfo.hasTransaction()) { 
if (logger.isTraceEnabled()) { 
logger.trace("Completing transaction for [" + 
txInfo.getJoinpoint 
Identification() + 
"] after exception: " + ex); 





} 

// 这 里 判断 是 否 回 滚 默认 的 依据 是 抛 出 的 异常 是 否 是 RuntimeExcep 
tion 或 者 是 Error 的 类 型 

if (txInfo.transactionAttribute.rollbackOn 








(ex)) { 
try { 
// 根 据 TrransactionStatus 信 息 进 行 回 深 处 理 
txliInfo.getTransactionManager().rollback(tx 
Info.GetTransaction Status()); 




















j 


catch (TransactionSystemException ex2) { 
logger.error("Application exception overri 
dden by rollback 
exception", ex); 
ex2.initApplicationException(ex); 
throw ex2; 
} 
catch (RuntimeException ex2) { 
logger.error("Application exception overri 
dden by rollback 
exception", ex); 
throw ex2; 
} 
catch (Error err) { 
logger.error("Application exception overri 
dden by rollback error", ex); 
throw err; 








} 

}else { 
// 如 果 不 满足 回 深 条 件 即 使 抛 出 异常 也 同样 会 提交 
try { 


txInfo.getTransactionManager().commit(txIn 
fo.getTransactionStatus()); 
} 
catch (TransactionSystemException ex2) { 
logger.error("Application exception overri 
dden by commit exception", ex); 
ex2.initApplicationException(ex); 
throw ex2; 
} 
catch (RuntimeException ex2) { 
logger.error("Application exception overri 
dden by commit exception", ex); 
throw ex2; 


j 


catch (Error err) { 


logger.error("Application exception overri 
dden by commit error", ex); 
throw err; 





在 对 目标 方法 的 执行 过 程 中 ， 一 旦 出 现 
Throwable 束 会 被 引导 全 此 方法 处 理 ， 但 是 并 不 代 
表 所 有 的 Throwable 都 会 补 回 深 处 理 ， 比 如 我 们 沼 
用 的 Exception， 默 认 是 不 会 被 处 理 的 。 默 认 情 况 
下 ， 即 使 出 现 异 常 ， 数 据 也 会 被 正常 提交 ， 而 这 个 





天 键 的 地 方 束 古 在 txInfo.transaction 
Attribute.rollbackOn(ex) 这 个 函数 。 


1. RA 


public boolean rollbackOn(Throwable ex) 
return (ex instanceof RuntimeException || ex instanceo 
f Error); 





看 到 了 吗 ? 默 认 情 况 下 Spring 中 的 事务 异常 处 理 
机 制 只 对 RuntimeException 和 Error 两 种 情况 感 兴 
趣 ， 当 然 你 可 以 通过 扩展 来 改变 ， 不 过 ， 我 们 最 各 
用 的 还 是 使 用 事务 提供 的 属性 设置 ， 利 用 注解 方式 
的 使 用 ， 例 如 : 


@Transactional(propagation=Propagation. REQUIRED, rollbackFor=Ex 
ception.class) 





2. ERA 


当然 ， 一 旦 符合 回 滚 条 件 ， 那 么 Spring 就 会 将 
程序 引导 至 回 滚 处 理 函数 中 。 








public final void rollback(TransactionStatus status) throws Tra 
nsactionException { 
// 如 果 事 务 已 经 完成 ， 那 么 再 次 回 滚 会 抛 出 异常 
if (status.isCompleted()) { 
throw new IllegalTransactionStateException( 


"Transaction is already completed - do not 
call commit or rollback 


more than once per transaction"); 


j 








DefaultTransactionStatus defStatus - (DefaultTransacti 
onStatus) status; 


processRollback(defStatus); 


} 
private void processRollback(DefaultTransactionStatus status) { 
try { 
try { 





// 激 活 所 有 TransactionSynchronization 中 对 应 的 方法 
triggerBeforeCompletion(status); 
if (status.hasSavepoint()) (1 
if (status.isDebug()) { 
logger.debug("Rolling back transaction 





to savepoint"); 














} 
// 如 果 有 保存 点 ， 也 就 是 当前 事务 为 单独 的 线程 则 会 退 到 
保存 点 


status.rollbackToHeldSavepoint 


0; 


else if (status.isNewTransaction()) { 
if (status.isDebug()) { 
logger.debug("Initiating transaction r 











ollback"); 
} 
// 如 果 当 前 事务 为 独立 的 新 事务 ， 则 直接 回 退 
doRollback 

(status); 


else if (status.hasTransaction()) { 
if (status.isLocalRollbackOnly() || isGlob 
alRollbackOnParticipation Failure()) { 
if (status.isDebug()) { 
logger.debug("Participating transa 
ction failed - marking existing transaction as rollback-only"); 








} 
// 如 果 当 前 事务 不 是 独立 的 事务 ， 那 么 只 能 标记 状态 
， 等 到 事务 链 执行 完毕 后 统一 回 滚 
doSetRollbackOnly(status); 
} 


else ( 
if (status.isDebug()) { 
logger.debug("Participating transa 
ction failed - letting transaction originator decide on rollbac 
k"); 





j 
j 
j 


else ( 
logger.debug("Should roll back transaction 
but cannot - no 
transaction available"); 


j 
j 


catch (RuntimeException ex) ( 
triggerAfterCompletion(status, TransactionSync 
hronization.STATUS UNKNOWN); 
throw ex; 


catch (Error err) { 
triggerAfterCompletion(status, TransactionSync 
hronization.STATUS UNKNOWN); 
throw err; 


j 





// 激 活 所 有 TransactionSynchronization 中 对 应 的 方法 
triggerAfterCompletion(status, TransactionSynchron 
ization.STATUS ROLLED BACK); 





finally ( 
// 清 空 记录 的 资源 并 将 挂 起 的 资源 恢复 
cleanupAfterCompletion 


(status); 





同样 ， 对 于 在 Spring 中 的 复杂 的 逻辑 处 理 过 





程 ， 在 入 口 函数 一 般 都 会 给 出 个 整体 的 处 理 脉络 ， 
而 把 实现 细节 委托 给 其 他 函数 去 执行 。 我 们 答 试 总 
结 下 Spring 中 对 于 回 秘 处 理 的 大 致 脉络 如 下 。 


1. 首先 是 目 定义 触发 器 的 调用 ， 包 括 在 回 滚 
前 、 完 成 回 深 后 的 调用 ， 当 然 完 成 回 深 包 括 正常 回 
深 与 回 深 过 程 中 出 现 异常 ， 目 定义 的 触 友 器 会 根据 
这 些 信 息 作 进一步 处 理 ， 而 对 于 触发 占 的 注册 ， 沿 
见 是 在 回调 过 程 中 通过 
TransactionSynchronizationManager 类 中 的 静态 方法 


直接 注册 : 


public static void registerSynchronization(TransactionSynchroni 
zation synchronization) 


2. 除了 触及 监听 函数 外 ， 束 古 真 正 的 回 深 你 
辑 处 理 了 。 




















。 当 之前 已 经 保存 的 事务 信息 中 有 保存 点 信息 的 
时 候 ， 使 用 你 存 扣 信息 进行 回 深 。 HT CA 
2 OST RRA TAS AE, A AY Se 

异常 并 不 会 引起 外 部 事务 的 回 深 。 


根据 你 存 挟 回 深 的 实现 方式 其 实 古 根据 乓 层 的 
数据 库 连 接 进 行 的 。 


public void rollbackToHeldSavepoint() throws TransactionExcepti 
on { 




















if (!hasSavepoint()) { 
throw new TransactionUsageException("No savepoint 
associated with current transaction"); 


getSavepointManager().rollbackToSavepoint 


(getSavepoint()); 
setSavepoint(null); 
} 








这 里 使 用 的 是 JDBC 的 方式 进行 数据 库 连 接 ， 
HKA getSavepointManager() FK 201 [n] WY ze 
JdbcTransactionObjectSupport, tH Wize WE IRI eA ži 
会 调用 JdbcTransactionObjectSupport 中 的 
rollbackToSavepoint 方 法 。 





public void rollbackToSavepoint(Object savepoint) throws Transa 
ctionException { 
try { 
getConnectionHolderForSavepoint().getConnection(). 
rollback((Savepoint) savepoint); 


catch (Throwable ex) { 
throw new TransactionSystemException("Could not ro 


ll back to JDBC savepoint", ex); 
} 


j 











。 当 之 前 已 经 保存 的 事务 信息 中 的 事务 为 新 事 
务 ， 那 么 直接 回 滩 。 第 用 于 单独 事务 的 处 理 。 
对 于 没有 保存 点 的 回 深 ，Spring 同 样 是 使 用 底层 
数据 库 连 接 提 供 的 API 来 操作 的 。 由 于 我 们 使 用 
[*] #2 DataSourceTransactionManager, AA 
doRollback K 24 fs FA EAS FASE 




















protected void doRollback(DefaultTransactionStatus status) { 

DataSourceTransactionObject txObject = (DataSourceTran 
sactionObject) status. 
getTransaction(); 

Connection con = txObject.getConnectionHolder().getCon 
nection(); 

if (status.isDebug()) { 

logger.debug("Rolling back JDBC transaction on Con 

nection [" + con + "]"); 

} 


try { 
con.rollback(); 


} 
catch (SQLException ex) { 
throw new TransactionSystemException("Could not ro 


ll back JDBC transaction", ex); 


j 


j 





。 当前 事务 信息 中 表明 是 存在 事务 的 ， 又 不 属于 
以 上 两 种 人 情况， 多数 用 于 JTA， 只 做 回 滚 标 识 ， 








等 到 提交 的 时 候 统 一 不 提交 。 
3. 回 深 后 的 信息 清除 
对 于 回 深 逻 辑 执行 结束 后 ， 无 论 回 深 是 否 


ee 





private void cleanupAfterCompletion(DefaultTransactionStatus st 
atus) { 
// 设 置 完 成 状态 
status.setCompleted(); 
if (status.isNewSynchronization()) ( 
TransactionSynchronizationManager.clear 


if (status.isNewTransaction()) { 
doCleanupAfterCompletion 


(status.getTransaction()); 


if (status.getSuspendedResources() != null) { 
if (status.isDebug()) { 
logger .debug("Resuming suspended transaction a 
fter completion of inner 

transaction"); 

} 

// 结 束 之 前 事务 的 挂 起 状态 

resume 








(status.getTransaction(), (SuspendedResourcesHolder) status.get 
Suspended Resources()); 


j 








从 函数 中 得 知 ， 事 务 处 理 的 收尾 处 理工 作 包括 
如 下 内 容 。 


。 设置 状态 是 对 事务 信息 作 完 成 标识 以 避免 重复 
调用 。 

。 如 果 当 前 事务 是 新 的 同步 状态 ， 需 要 将 绑 定 到 
当前 线程 的 事务 信息 清除 。 

。 如 果 是 新 事务 需要 做 些 清除 资源 的 工作 。 


























protected void doCleanupAfterCompletion(Object transaction) { 
DataSourceTransactionObject txObject - (DataSourceTran 
sactionObject) transaction; 


if (txObject.isNewConnectionHolder()) { 

// 将 数据 库 连 接 从 当前 线程 中 解除 绑 定 

TransactionSynchronizationManager.unbindResource(t 
his.dataSource); 


} 
// 释 放 链 接 


Connection con = txObject.getConnectionHolder().getCon 
nection(); 
try { 
if (txObject.isMustRestoreAutoCommit()) 1 
// 恢 复数 据 库 连接 的 自动 提交 属性 


con.setAutoCommit(true); 











—= 








} 
// 重 置 数据 库 连 接 
DataSourceUtils.resetConnectionAfterTransaction(co 
n, txObject.getPrevious 
IsolationLevel()); 





catch (Throwable ex) { 
logger.debug("Could not reset JDBC Connection afte 
r transaction", ex); 


j 


if (txObject.isNewConnectionHolder()) { 
if (logger.isDebugEnabled()) (1 


logger.debug("Releasing JDBC Connection [" +c 
on + "] after transaction"); 











i 
// 如 果 当 前 事务 时 独立 的 新 创建 的 


alin 








有 务 则 在 事务 完成 时 释放 数据 库 连 





接 
DataSourceUtils.releaseConnection(con, this.dataSo 
urce); 
} 
txObject.getConnectionHolder().clear(); 
} 





。 如 果 在 事务 执行 前 有 事务 挂 起 ， 那 么 当前 事务 
执行 结束 后 需要 将 挂 起 事务 恢复 。 
protected final void resume(Object transaction, SuspendedResour 


cesHolder resourcesHolder) 
throws TransactionException { 








if (resourcesHolder != null) { 
Object suspendedResources = resourcesHolder.suspen 
dedResources; 
if (suspendedResources !- null) { 
doResume(transaction, suspendedResources); 
} 


List<TransactionSynchronization> suspendedSynchron 
izations = resourcesHolder. 
suspendedSynchronizations; 
if (suspendedSynchronizations !- null) { 
TransactionSynchronizationManager.setActualTra 
nsactionActive (resources Holder.wasActive); 
TransactionSynchronizationManager.setCurrentTr 
ansactionIsolationLevel 
(resourcesHolder.isolationLevel); 
TransactionSynchronizationManager.setCurrentTr 
ansactionReadOnly 
(resourcesHolder.readOnly); 
TransactionSynchronizationManager.setCurrentTr 
ansactionName 
(resourcesHolder.name); 
doResumeSynchronization(suspendedSynchronizati 





10.3.3 ”事务 提交 


之 前 我 们 分 析 了 Spring 的 事务 异常 处 理 机 制 ， 
那么 事务 的 执行 并 没有 出 现任 何 的 异常 ， 也 束 音 味 
ARR NEEE RA ELE S o 


protected void commitTransactionAfterReturning(TransactionInfo 
txlInfo) { 
if (txInfo != null && txInfo.hasTransaction()) { 
if (logger.isTraceEnabled()) { 
logger.trace("Completing transaction for [" + 
txInfo.getJoinpoint 
Identification() + "]"); 


txliInfo.getTransactionManager().commit(txInfo.getTr 
ansactionStatus()); 


j 
j 











在 真正 的 数据 提交 之 前 ， 还 需要 做 个 判断 。 不 
知道 大 家 还 有 没有 印象 ， 在 我 们 分 析 事 务 寞 党 处 理 
规则 的 时 候 ， 当 某 个 事务 既 没 有 保存 点 又 不 是 新 事 
务 ，Spring 对 它 的 处 理 方式 只 是 设置 一 个 回 深 标 
识 。 这 个 回 深 标 识 在 这 里 就 会 派 上 用 场 了 ， 主 要 的 
应 用 场景 如 下 。 
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些 事务 又 不 在 Spring 的 管理 范围 内 ， 或 者 无 法 设置 
保存 点 ， 那 么 Spring 会 通过 设置 回 滚 标 识 的 方式 来 
森 止 提交 。 站 和 完 当 茶 个 区 入 事务 友 生 回 深 的 时 候 会 
设置 回 深 标 识 ， 而 等 到 外 部 事务 提交 时 ， 一 旦 判断 
出 当前 事务 流 被 设置 了 回 滚 标识 ， 则 由 外 部 事务 来 
统一 进行 整体 事务 的 回 滚 。 


所 以 ， 当 事务 没有 航 开 第 捕获 的 时 候 也 并 不 意 
味 看 一 定 会 执行 近 交 的 过 程 。 





























public final void commit(TransactionStatus status) throws Trans 
actionException { 
if (status.isCompleted()) { 
throw new IllegalTransactionStateException( 
"Transaction is already completed - do not 
call commit or rollback 
more than once per transaction"); 


j 


DefaultTransactionStatus defStatus - (DefaultTransacti 
onStatus) status; 
// 如 果 在 事务 链 中 已 经 被 标记 回 滚 ， 那 么 不 会 尝试 提交 事务 ， 直 接 回 滚 
if (defStatus.isLocalRollbackOnly()) ( 
if (defStatus.isDebug()) { 
logger.debug("Transactional code has requested 














rollback"); 
processRollback 


(defStatus); 
return; 


} 
if (!shouldCommitOnGlobalRollbackOnly() && defStatus.i 
sGlobalRollbackOnly()) { 
if (defStatus.isDebug()) { 
logger .debug( "Global transaction is marked as 


rollback-only but 
transactional code requested commit"); 


j 


processRollback 


(defStatus); 
if (status.isNewTransaction() || isFailEarlyOnGlob 
alRollbackOnly()) { 
throw new UnexpectedRollbackException( 
"Transaction rolled back because it ha 
S been marked as rollback-only"); 


j 


return; 

















} 
// 处 理事 务 提交 
processCommit 








(defStatus); 
} 





而 当 事 务 执行 一 切 都 正常 的 时 候 ， 便 可 以 真正 
地 进入 提交 流程 了 。 





private void processCommit(DefaultTransactionStatus status) thr 
ows TransactionException { 
try { 
boolean beforeCompletionInvoked - false; 
try 1 
// 预 留 
prepareForCommit(status); 
// 添 加 的 TransactionSsynchronization 中 的 对 应 方法 的 调 








triggerBeforeCommit(status); 
// 添 加 的 TransactionSynchronization 中 的 对 应 方法 的 调 





triggerBeforeCompletion(status); 

beforeCompletionInvoked = true; 

boolean globalRollbackOnly = false; 

if (status.isNewTransaction() || isFailEarlyOn 
GlobalRollbackOnly()) { 


globalRollbackOnly - status.isGlobalRollba 
ckOnly(); 


if (status.hasSavepoint()) { 
if (status.isDebug()) { 
logger .debug("Releasing transaction sa 
vepoint"); 








} 
/7/ 如 果 存 在 保存 点 则 清除 保存 点 信息 


status.releaseHeldSavepoint(); 





else if (status.isNewTransaction()) { 
if (status.isDebug()) { 
logger.debug("Initiating transaction c 
ommit"); 








} 
// 如 果 是 独立 的 事务 则 直接 提交 
doCommit 


(status); 


} 
if (globalRollbackOnly) ( 
throw new UnexpectedRollbackException( 
"Transaction silently rolled back 
because it has been 
marked as rollback-only"); 


} 
catch (UnexpectedRollbackException ex) { 
triggerAfterCompletion(status, TransactionSync 
hronization.STATUS 
ROLLED BACK); 
throw ex; 


catch (TransactionException ex) { 

if (isRollbackOnCommitFailure()) { 
doRollbackOnCommitException(status, ex); 

} 

else { 
triggerAfterCompletion(status, TransactionS 

ynchronization.STATUS UNKNOWN); 
} 


throw ex; 


} 


catch (RuntimeException ex) { 


if (!beforeCompletioninvoked) { 
triggerBeforeCompletion(status); 


doRollbackOnCommitException(status, ex); 
throw ex; 


catch (Error err) { 
if (!beforeCompletioninvoked) { 
// 添 加 的 TransactionSynchronization 中 的 对 应 方 











法 的 调用 
triggerBeforeCompletion(status); 
j 
// 提 交 过 程 中 出 现 异 常 则 回 滚 
doRollbackOnCommitException(status, err); 
throw err; 
j 
try { 
// 添 加 的 TransactionSynchronization 中 的 对 应 方法 的 调 
用 
triggerAfterCommit(status); 
j 
finally { 


triggerAfterCompletion(status, TransactionSync 
hronization.STATUS COMMITTED); 


} 
} 
finally { 
cleanupAfterCompletion(status); 
} 








在 提交 过 程 中 也 并 不 是 直接 提交 的 ， 而 是 考虑 
了 诺 多 的 方面 ， 符 合 提 交 的 条 件 如 下 。 





t 党 事务 状态 中 有 保存 点 信息 的 话 便 不 会 去 提交 
。 当 事务 非 新 事务 的 时 候 也 不 会 去 执行 提交 事务 
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务 ， 在 Spring 中 正常 的 处 理 方 式 是 将 内 髓 事务 开始 
之 前 设置 保存 点 ， 一 旦 内 髓 事务 出 现 异 常 便 根据 保 
存 点 信息 进行 回 深 ， 但 是 如 果 没 有 出 现 异 常 ， 内 髓 
事务 并 不 会 单独 提交 ， 而 是 根据 事务 流 由 最 外 层 事 
务 负责 提交 ， 上 所 以 如 果 当 前 存在 保存 点 信息 便 不 是 
最 外 层 事务 ， 不 做 保存 操作 ， 对 于 是 否 是 新 事务 的 
判断 也 是 基于 此 考虑 。 


如 果 程 序 流通 过 了 事务 的 层 层 把 关 ， 最 后 顺利 
地 进入 了 提交 流程 ， 那 么 同样 ，Spring 会 将 事务 提 
区 的 操作 引导 人 至 底层 数据 库 连 接 的 API， 进 行事 务 


提交 。 



































protected void doCommit(DefaultTransactionStatus status) { 

DataSourceTransactionObject txObject - (DataSourceTran 
sactionObject) status. getTransaction(); 

Connection con - txObject.getConnectionHolder().getCon 
nection(); 

if (status.isDebug()) ( 

logger.debug("Committing JDBC transaction on Conne 

ction [" + con + "]"); 


} 
try { 
con.commit(); 


} 
catch (SQLException ex) { 


throw new TransactionSystemException("Could not co 
mmit JDBC transaction", ex); 


j 


115 SpringMVC 


Spring 框 架 提 供 了 构建 Web 应 用 程序 的 全 功能 
MVC 模 块 。 通 过 策略 接口 ，Spring 框 架 是 高 上 度 可 配 
置 的 ， 而 且 文 持 多 种 视图 拉 术 ， 例 如 JavaServer 
Pages (JSP) 、Velocity、Tiles、iText 和 POI。 
SpringMVC 框 架 并 不 知道 使 用 的 视图 ， 所 以 不 会 强 
据 您 只 使 用 JSP 技 术 。SpringMVC 分 离 了 控制 器 、 
模型 对 象 、 分 派 器 以 及 处 理 程序 对 象 的 角色 ， 这 种 
分 离 让 它们 更 容易 进行 定制 。 


Spring 的 MVC 是 基于 Servlet 功 能 实现 的 ， 通 过 
实现 Servlet 接 口 的 DispatcherServlet 来 封装 其 核心 功 
能 实现 ， 通 过 将 请 求 分 派 给 处 理 程序 ， 同 时 带 有 可 
配置 的 处 理 程序 映射 、 视 图 解析 、 本 地 语言 、 主 题 
解析 以 及 上 载 文件 文 持 。 默 认 的 处 理 程序 是 非 利 简 
单 的 Controller 接 口 ， 只 有 一 个 方法 ModelAndView 
handleRequest(request, response)。Spring 提 供 了 一 个 
控制 韶 层 次 结构 ， 可 以 派生 子 类 。 如 有 果 应 用 程序 需 
要 人 处理 用 户 输 入 表单 ， 那 么 可 以 继承 
AbstractFormController。 如 果 需 要 把 多 页 输入 处 理 
到 一 个 表单 ， 那 么 可 以 继承 
AbstractWizardFormController. 











对 SpringMVC 或 者 其 他 比较 成 熟 的 MVC 框 架 而 
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。 根 据 不 同 的 请 求 处 理 不 同 的 逻辑 单元 。 
。 返回 处 理 结 朱 数 据 并 跳 转 全 啊 应 的 页 面 。 


我 们 首先 通过 一 个 简单 示例 来 快速 回顾 
SpringMVC 的 使 用 。 





11.1 SpringMVC 快 速 体验 


1. 配置 web.xml 


一 个 Web 中 可 以 没有 web.xml 文 件 ， 也 就 是 
说 ，web.xml 文 件 并 不 是 Web 工 程 必需 的 。web.xml 
文件 用 来 初始 化 配置 信息 ， 比 如 Welcome 页 面 、 
servlet、servlet-mapping、filter、jlistener、 局 动 加 载 
级 别 等 。 但 是 ，SpringMVC 的 实现 原理 是 通过 
servlet 拦 规 所 有 URL 来 达到 控制 的 目的 ， 所 以 
web.xml 的 配置 是 必需 的 。 








<?xml version="1.0" encoding="UTF-8"?> 

«web-app id-"WebApp ID" version="2.5" xmins="http://java.sun.co 
m/xml/ns/javaee" xmlns:xsi-'http://www.w3.0rg/2001/XMLSchema-in 
stance" xsi:schemaLocation="http://java.sun. com/ 

xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app 2 5.xsd 


Ws 
<display -name>Springmvc</display -name> 





























<!-- 使 用 ContextLoaderListener 配 置 时 ， 需 要 告诉 它 Spring 配 置 文件 
的 位 置 --> 
«context-param» 
<param-name>contextConfigLocation 


</param-name> 
<param-value>classpath:applicationContext.xml</param-va 
lue» 
«/context-param» 


<!-- SpringMVC 的 前 端 控制 器 --> 
<!-- 当 DispatcherServlet 载 入 后 ， 它 将 从 一 个 XML 文 件 中 载 入 Spring 的 应 
用 上 下 文 ， 该 XML 文 件 的 名 字 取 决 于 <servlet-name> --> 
«1-- 这 里 DispatcherServlet 将 试图 从 一 个 叫 作 Springmvc-servlet .xml 
的 文件 中 载 入 应 用 上 下 文 ， 其 默认 位 于 WEB-INF 目 录 下 --> 
<servlet> 
<servlet -name>Springmvc</servlet -name> 
<servlet-class>org.Springframework.web.servlet.Dispatch 
erServlet 











</servlet-class> 
<load-on-startup>1</load-on-startup> 
</servlet> 
<servlet -mapping> 
<servlet -name>Springmvc</servlet -name> 
<url-pattern>*.htm</url-pattern> 
</servlet -mapping> 














«1-- 配置 上 下 文 载 入 器 --> 

<!-- 上 下 文 载 入 器 载 入 除 DispatcherServlet 载 入 的 配置 文件 之 外 的 其 他 上 
下 文 配 置 文件 --> 

«1-- 最 常用 的 上 下 文 载 入 器 是 一 个 Servlet 监 听 器 ， 其 名 称 为 ContextLoade 
rListener --» 

«listener» 

<listener-class>org.Springframework.web.context.Context 

LoaderListener 
</listener-class> 

</listener> 
</web-app> 
































Spring 的 MVC 之 所 以 必须 要 配置 web.xml， 其 
实 最 关键 的 是 要 配置 两 个 地 方 。 











e contextConfigLocation: Spring 的 核心 束 是 配置 
文件 ， 可 以 说 配置 文件 是 Spring 中 必 不 可 少 的 东 
西 ， 而 这 个 参数 就 是 使 Web 与 Spring 的 配置 文件 
相 结合 的 一 个 关键 配置 。 

e DispatcherServlet: (i J SpringMVCH ig KZ 
辑 ，Spring 使 用 此 类 拦截 Web 请 求 并 进行 相应 的 
逻辑 处 理 。 





2. 创建 Spring 配置 文件 applicationContext.xml 


<?xml version="1.0" encoding="UTF-8"?> 
«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xmins:tx="http://www.Springframework.org/schema/tx" 
xsi:schemaLocation-"http://www.Springframework.org/schema/b 
eans 
http://www.Springframework.org/schema/beans/Spring-beans-2. 
5.xsd 
http://www. Springframework.org/schema/tx 
http://www. Springframework.org/schema/tx/Spring-tx-2.5.xsd" 


<bean id="viewResolver" class="org.Springframework.web.serv 
let.view. Internal Resource 
ViewResolver'"> 
<property name="prefix" value="/WEB-INF/jsp/"/> 
«property name-z"suffix" value=".jsp"/> 
</bean> 
</beans> 





InternalResourceViewResolverzé — ^ 4f HJJ 
bean， 会 在 ModelAndView 返 回 的 视图 名 前 加 上 
prefix 指 定 的 前 经， 由 在 最 后 加 上 suffix 指 定 的 后 
级 ， 例 如 : 由 于 XXController 返 回 的 ModelAndView 
中 的 视图 名 是 testview， 故 该 视图 解析 器 将 在 /WEB- 
INF/jsp/testview.jsp 处 查找 视图 。 





3. 创建 model 





模型 对 于 SpringMVC 来 说 并 不 是 必 不 可 少 ， 如 
果 处 理 程序 非常 简单 ， 完 全 可 以 忽略 。 模 型 创建 主 
要 的 目的 就 是 承载 数据 ， 使 数据 传输 更 加 方便 。 


public class User { 
private String username; 
private Integer age; 
public String getUsername() ( 
return username; 


public void setUsername(String username) { 
this.username - username; 


j 
public Integer getAge() { 
return age; 


} 
public void setAge(Integer age) { 
this.age = age; 





4. 创建 controller 
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public class UserController extends AbstractController { 
@Override 
protected ModelAndView handleRequestInternal(HttpServletReq 
uest arg0, HttpServletResponse arg1) throws Exception { 
List«User» userList = new ArrayList<User>(); 
User userA = new User(); 
User userB = new User(); 
userA.setUsername("sk="); 
userA.setAge(27); 
userB. setUsername("2=)"); 
userB.setAge(37); 
userList.add(userA); 
userList.add(userB); 


return new ModelAndView("userlist", "users", userList); 





在 请 求 的 最 后 返回 了 ModelAndView 类 型 的 实 
例 。ModelAndView 类 在 SpringMVC 中 占有 很 重要 
的 地 人 位， 控制 器 执行 方法 都 必须 返回 一 个 
ModelAndView，ModelAndView 对 象 保 存 了 视图 以 
及 视图 显示 的 模型 数据 ， 例 如 其 中 的 参数 如 下 。 


e 第 1 个 参数 userlist: 视图 组 件 的 逻辑 名 称 。 这 里 
视图 的 逻辑 名 称 就 是 userlist， 视 图 解析 器 会 使 
用 该 名 称 查 找 实 际 的 View 对 象 。 

。 第 2 个 参数 users: 传递 给 视图 的 模型 对 象 的 名 
称 。 











。 第 3 个 参数 userList: 传递 给 视图 的 模型 对 象 的 
{Be 


5. 创建 视图 文件 userlist.jsp 


<%@ page language="java" pageEncoding="UTF-8"%> 
<%@ taglib prefix-"c" uri="http://java.sun.com/jsp/jstl/core"%> 


<h2>This is SpringMVC demo page</h2> 
«c:forEach items="${users}" var="user"> 
«c:out value="${user.username}"/><br/> 
«c:out value="${user.age}"/><br/> 
«/c:forEach» 








视图 文件 用 于 展现 请 求 处 理 结果 ， 通 过 对 JSTL 
的 支持 ， 可 以 很 方便 地 展现 在 控制 器 中 放 入 
ModelAndView 中 的 处 理 结果 数据 。 








6. 创建 Servlet 配 置 文件 Spring-servlet.xml 





<?xml version="1.0" encoding="UTF-8"?> 
«beans xmlns="http://www.Springframework.org/schema/beans" 
xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" xmln 
s:tx="http://www. Spring 
framework. org/schema/tx" 
xsi:schemaLocation-"http://www.Springframework.org/schema/ 
beans 
http://www.Springframework.org/schema/beans/Spring-beans-2. 
5.xsd 
http://www.Springframework.org/schema/tx 
http://www.Springframework.org/schema/tx/Spring-tx-2.5.xsd" 


«bean id-"simpleUrlMapping" 
class-z"org.Springframework.web.servlet.handler.SimpleU 
rlHandlerMapping"> 
<property name="mappings"> 
<props> 
<prop key="/userlist.htm">userController</prop 


</props> 
</property> 
</bean> 


<!-- 这 里 的 1d="userController" 对 应 的 是 <bean id="simpleUr1lMapp 
ing"> 中 的 <prop> 里 面 的 value --> 

«bean id="userController" class="test.controller.UserContr 
oller" /> 


</beans> 





为 SpringMVC 是 基于 Servlet 的 实现 ， 所 以 在 





Web 局 动 的 时 候 ， 服 务 絮 会 首先 尝试 加 载 对 应 于 
Servlet 的 配置 文件 ， 而 为 了 让 项 目 更 加 模块 化 ， 通 
第 我 们 将 Web 部 分 的 配置 都 存放 于 此 配置 文件 中 。 


至 此 ， 己 经 完成 了 SpringMVC 的 搭建 ， 启 动 服 
务 器 ， 输 入 网 址 http://localhost:8080/ 
Springmvc/userlist.htm 。 


看 到 了 服务 器 返回 界面 ， 如 图 11-1 所 示 。 


Æ http:;//localhost:S080/springmvc/userlist.htm 





This is SpringMVC demo page 


图 11-1 SpringMVC 快 速 体验 
11.2 ContextLoaderListener 


对 于 SpringMVC 功 能 实现 的 分 析 ， 我 们 首先 从 
web.xml F iR, web.xml L FRA] E eie E 
是 ContextLoaderListener， 那 么 它 所 提供 的 功能 有 哪 
些 ， 又 是 如 何 实现 的 呢 ? 


当 使 用 编程 方式 的 时 候 我 们 可 以 耳 接 将 Spring 
配置 信息 作为 参数 传 入 Spring 容 如 中 ， 如 








ApplicationContext ac-new ClassPathXmlApplicationContext("appli 
cationContext.xml"); 








但 是 在 Web 下 ， 我 们 需要 更 多 的 是 与 Web 环 境 
相互 结合 ， 通 第 的 办 法 是 将 路 径 以 context-param 的 
方式 注册 并 使 用 ContextLoaderListener 进 行 监 听 读 
AY. 
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时 ， 自 动 装配 ApplicationContext 的 配置 信息 。 因 为 
它 实 现 了 ServletContextListener 这 个 接口 ， 在 
web.xml 配 置 这 个 监 昕 器 ， 启 动容 器 时 ， 就 会 默认 
执行 它 实 现 的 方法 ， 使 用 ServletContextListener 接 
口 ， 开 发 者 能 够 在 为 客户 端 请 求 提 供 服务 之 前 辐 
ServletContext 中 诬 加 任意 的 对 象 。 这 个 对 象 在 
ServletContext 局 动 的 时 候 被 初始 化 ， 然 后 在 
ServletContext 整 个 运行 期 间 都 是 可 见 的 。 





每 一 个 Web 应 用 都 有 一 个 ServletContext 与 之 相 
关联 。ServletContext 对 象 在 应 用 启动 时 被 创建 ， 在 
应 用 关闭 的 时 候 被 销毁 。ServletContext 在 全 局 范 
内 有 效 ， 类 似 于 应 用 中 的 一 个 全 局 变量 。 


在 ServletContextListener 中 的 核心 逻辑 便 是 初 


始 化 WebApplicationContext 实 例 并 存放 至 
ServletContext 中 。 


11.2.1 ServletContextListener H^ 1E Hj 


正 却 分 析 代 码 前 我 们 同样 还 是 首先 了 解 
ServletContextListener 的 使 用 。 


1. 创建 自 定义 ServletContextListener 


首先 我 们 创建 ServletContextListener， 目标 是 
在 系统 局 动 时 添加 目 定 义 的 属性 ， 以 便于 在 全 局 范 
内 可 以 随时 调用 。 系 统 启动 的 时 候 会 调用 
ServletContextListener 实 现 类 的 contextInitialized 方 
E 所 以 需要 在 这 个 方法 中 实现 我 们 的 初始 化 逻 
H. 





public class MyDataContextListener implements ServletContextLis 
tener ( 


private ServletContext context - null; 
public MyDataContextListener () { 


j 














// 该 方法 在 Servletcontext 启 动 之 后 被 调用 ， 并 准备 好 处 理 客户 端 请 求 
public void contextInitialized(ServletContextEvent event) { 
this.context - event.getServletContext(); 

















// 通 过 你 可 以 实现 自己 的 逻辑 并 将 结果 记录 在 属性 中 
context = setAttribute("myData","this is myData"); 
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// 这 个 方法 在 ServletContext 将 要 关闭 的 时 候 调 用 
public void contextDestroyed(ServletContextEvent event)t{ 
this.context = null; 
} 
} 























2. iE A UT ae 


在 web.xml 文 件 中 需要 注册 目 定 义 的 监听 器 。 


«listener» 
com.test.MyDataContextListener 
</listener> 


3. 测试 


— H WebM H5 JE, Sf tre CE TEXT 
Servlet 或 者 JSP 中 通过 下 面 的 方式 获取 我 们 初始 化 
的 参数 ， 如 下 : 


String myData = (String) getServletContext().getAttribute("myDa 
ta"); 


11.2.2. ”Spring 中 的 
ContextLoaderListener 


分 析 了 ServletContextListener 的 使 用 方式 后 再 
来 分 析 Spring 中 的 ContextLoaderListener 的 实现 就 容 
易 理 解 得 多 ， 虽 然 ContextLoaderListener 实 现 的 逻辑 
要 复杂 得 多 ， 但 是 大 致 的 套路 还 是 万 变 不离 其 宗 。 


ServletContext 局 动 之 后 会 调用 
ServletContextListener 的 contextInitialized 方 法 ， 屠 
么 ， 我 们 束 从 这 个 函数 开始 进行 分 析 。 








public void contextInitialized(ServletContextEvent event) 
this.contextLoader = createContextLoader(); 
if (this.contextLoader -- null) ( 
this.contextLoader - this; 


} 
// 初 始 化 WebApplicationContext 


this.contextLoader.initWebApplicationContext 


(event.getServletContext()); 
} 





这 里 涉及 了 一 个 弟 用 类 
eae 在 web 应 用 中 ， 我 们 会 用 
到 WebApplication Context, WebApplicationContext 
继承 目 ApplicationContext， 在 ApplicationContext 的 
基础 上 又 退 加 了 一 些 特 定 于 Web 的 操作 及 属性 ， 
非常 类 似 于 我 们 通过 编程 方式 使 用 Spring E r 
ClassPathXmlApplicationContext 类 提供 的 功能 。 继 
续 跟 踩 代码 : 








public WebApplicationContext initWebApplicationContext(ServletC 
ontext servletContext) { 
if (servletContext.getAttribute(WebApplicationContext. 
ROOT WEB APPLICATION 
CONTEXT. ATTRIBUTE) !- null) ( 
//web .xml 中 存在 多 次 ContextLoader 定 义 
throw new IllegalStateException( 

"Cannot initialize context because there i 
s already a root application context present - " + 

"check whether you have multiple ContextLo 
ader* definitions in 
your web.xml!"); 


j 





Log logger = LogFactory.getLog(ContextLoader.class); 


servletContext.log("Initializing Spring root WebApplic 
ationContext"); 
if (logger.isInfoEnabled()) { 
logger.info("Root WebApplicationContext: initializ 
ation started"); 


j 


long startTime - System.currentTimeMillis(); 


try { 
// Store context in local instance variable, to gu 
arantee that 
// it is available on ServletContext shutdown. 
if (this.context == null) { 
// 初 始 化 context 
this.context = createWebApplicationContext 


(servletContext); 


if (this.context instanceof ConfigurableWebApplica 
tionContext) { 
configureAndRefreshWebApplicationContext( (Conf 
igurableWebApplication 
Context)this.context, servletContext); 


} 
// 记 录 在 servletcontext 中 
servletContext.setAttribute(WebApplicationContext. 
ROOT WEB APPLICATION 
CONTEXT ATTRIBUTE, this.context); 


ClassLoader ccl = Thread.currentThread().getContex 
tClassLoader(); 
if (ccl == ContextLoader.class.getClassLoader()) (1 
currentContext - this.context; 


else if (ccl !- null) ( 
currentContextPerThread.put(ccl, this.context) 


j 


if (logger.isDebugEnabled()) (1 
logger.debug("Published root WebApplicationCon 
text as ServletContext attribute with name [" + 
WebApplicationContext.ROOT WEB APPLICA 


TION CONTEXT ATTRIBUTE-"]"); 


} 
if (logger.isInfoEnabled()) { 
long elapsedTime - System.currentTimeMillis() 
- startTime; 
logger.info("Root WebApplicationContext: initi 
alization completed in " + elapsedTime + " ms"); 


j 


return this.context; 
} 
catch (RuntimeException ex) { 
logger.error("Context initialization failed", ex); 
servletContext.setAttribute(WebApplicationContext. 
ROOT WEB APPLICATION 
CONTEXT ATTRIBUTE, ex); 
throw ex; 


catch (Error err) { 
logger.error("Context initialization failed", err) 
了 
servletContext.setAttribute(WebApplicationContext. 
ROOT WEB APPLICATION 
CONTEXT ATTRIBUTE, err); 
throw err; 


j 





initWebApplicationContext A Zi © 22 e AH f e 
建 WebApplicationContext 实 例 的 一 个 功能 架构 ， 从 
函数 中 我 们 看 到 了 初始 化 的 大 致 步 又 。 


1. WebApplicationContext 存 在 性 的 验证 。 


在 配置 中 只 人 允许 声明 一 次 
ServletContextListener， 多 次 声明 会 扰乱 Spring 的 执 
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录 在 ServletContext 中 以 方便 全 局 调用 ， 而 使 用 的 
key Wie 
WebApplicationContex.ROOT WEB. APPLICATION 
Hr DAYS UE 77 st x £t ServletContextS: ffl F ze FH 
有 对 应 key 的 属性 。 


2. 创建 WebApplicationContext 实 例 。 











如 条 通过 验证 ， 则 Spring 将 创建 
WebApplicationContext 实 例 的 工作 委托 给 create 
WebApplicationContext PA 2 . 





protected WebApplicationContext createWebApplicationContext(Ser 
vletContext sc) ( 
Class<?> contextClass = determineContextClass 


(sc); 
if (!ConfigurableWebApplicationContext.class.isAssigna 
bleFrom(contextClass)) { 
throw new ApplicationContextException("Custom cont 
ext class [" + context 
Class.getName() + 
"] is not of type [" + ConfigurablewebAppl 
icationContext.class.getName() + "]"); 


ConfigurableWebApplicationContext wac - 
(ConfigurableWebApplicationContext) BeanUtils. 
instantiateClass (contextClass); 
return wac; 
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protected Class<?> determineContextClass 


(ServletContext servletContext) { 
//CONTEXT CLASS PARAM = "contextClass"; 

String contextClassName - servletContext.getInitParame 
ter(CONTEXT CLASS PARAM); 

if (contextClassName !- null) ( 

try { 
return ClassUtils.forName(contextClassName, Cl 

assUtils.getDefaultClass Loader()); 


catch (ClassNotFoundException ex) { 
throw new ApplicationContextException( 
"Failed to load custom context class [ 
" + contextClassName + "]",ex); 


} 
} 
else ( 
contextClassName = defaultStrategies.getProperty(W 
ebApplicationContext. 
class.getName()); 


try { 
return ClassUtils.forName(contextClassName, Co 


ntextLoader.class. 
getClassLoader()); 

} 

catch (ClassNotFoundException ex) { 

throw new ApplicationContextException( 
"Failed to load default context class 

[" + contextClassName + "]",ex); 

} 

} 





其 中 ， 在 ContextLoader 类 中 有 这 样 的 静态 代码 





static ( 


// Load default strategy implementations from properti 
es file. 


// This is currently strictly internal and not meant t 
o be customized 
// by application developers. 
try { 
//DEFAULT STRATEGIES PATH - "ContextLoader.propert 
ies" 
ClassPathResource resource - new ClassPathResource 
(DEFAULT STRATEGIES PATH, 
ContextLoader.class); 
defaultStrategies - PropertiesLoaderUtils.loadProp 
erties(resource); 


catch (IOException ex) ( 
throw new IllegalStateException("Could not load 'C 
ontextLoader.properties': " 
+ ex.getMessage( )); 


j 


j 





根据 以 上 静态 代码 块 的 内 容 ， 我 们 推 鞭 在 当前 
类 ContextLoader 同 样 日 录 下 必定 会 存在 属性 文件 
ContextLoader.properties， 查 看 后 果然 存在 ， 内 容 如 
下 : 





org.Springframework.web.context.WebApplicationContext-org.Sprin 
gframework.web.context.support.XmlWebApplicationContext 





综合 以 上 代码 分 析 ， 在 初始 化 的 过 程 中 ， 程 序 
首先 会 读 取 ContextLoader 类 的 同 目 录 下 的 属性 文件 
ContextLoader.properties， 并 根据 其 中 的 配置 提取 将 
要 实现 WebApplicationContext 接 口 的 实现 类 ， 并 根 
据 这 个 实现 类 通过 反射 的 方式 进行 实例 的 创建 。 








3. 将 实例 记录 在 servletContext 中 。 


4. 映 映 当 前 的 类 加 载 右 与 创建 的 实例 到 全 局 


变量 currentContextPerThread 中 。 


11.3 DispatcherServlet 


在 Spring 中 ，ContextLoaderListener 只 是 辅助 功 
能 ， 用 于 创建 WebApplicationContext 类 型 实例 ， 而 
真正 的 逻辑 实现 其 实 是 在 DispatcherServlet 中 进行 
的 ，DispatcherServlet 是 实现 servlet 接 口 的 实现 类 。 


servlet 是 一 个 Java 编 写 的 程序 ， 此 程序 是 基于 
HTTP 协 议 的 ， 在 服务 器 端 运 行 的 〈 如 Tomcat) ， 
是 按照 servlet 规 苑 编写 的 一 个 Java 类 。 主 要 是 处 理 
客户 端的 请 求 并 将 其 结果 发 送 到 客户 端 。servlet 的 
生命 周期 是 由 servlet 的 容器 来 控制 的 ， 它 可 以 分 为 3 
个 阶段 : 初始化、 运行 和 销毁 。 











1. 初始 化 阶段 


e ServVlet 容 器 加 载 servlet 类 ， 把 servlet 类 的 .class 文 
件 中 的 数据 读 到 内 存 中 。 

e servlet ZEO — Tl ServletConfigX] & . 
ServletConfig 对 象 包 含 了 servlet 的 初始 化 配置 信 
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e Servlet 容 器 创建 一 个 servlet 对 象 。 
e servlet 容器 调用 servlet 对 象 的 init 方 法 进行 初始 
化 。 


2. 运行 阶段 


当 servlet 容 器 接收 到 一 个 请 求 时 ，servlet 容 器 
会 针对 这 个 请 求 创建 servletRequest 和 
servletResponse 对 象 ， 然 后 调用 service 方 法 。 并 把 
这 两 个 参数 传递 给 service 方 法 。service 方 法 通过 
servletRequest 对 和 象 获得 请 求 的 信息 。 并 处 理 该 请 
求 。 再 通过 servletResponse 对 象 生 成 这 个 请 求 的 啊 
应 结果 。 然 后 销毁 servletRequest 和 servletResponse 
对 象 。 我 们 不 管 这 个 请 求 是 post 提 区 的 还 是 get 提 区 
的 ， 最 终 这 个 请 求 都 会 由 service 方 法 来 处 理 。 








3. FA E 


当 Web 应 用 被 终止 时 ，servlet 容 器 会 先 调 用 
servlet 对 象 的 destrory 方 法 ， 然 后 再 销毁 servlet 对 
象 ， 同 时 也 会 销毁 与 servlet 对 象 相关 联 的 
servletConfig 对 象 。 我 们 可 以 在 destroy 方 法 的 实现 
中 ， 释 放 servlet 所 占用 的 资源 ， 如 关闭 数据 库 连 
接 ， 关 闭 文件 输入 输出 流 等 。 








servlet 的 框架 是 由 两 个 Java 包 组 成 : 
javax.servlet 和 和 javax.servlet.http。 在 javax.servlet 包 中 
定义 了 所 有 的 servlet 类 都 必须 实现 或 扩展 的 通用 接 
口 和 类 ， 在 javax.servlet.http 包 中 定义 了 采用 HTTP 
通信 协议 的 HttpServlet 类 。 





servlet 被 设计 成 请 求 驱 动 ，servlet 的 请 求 可 能 
包含 多 个 数据 项 ， 当 Web 容 器 接收 到 某 个 servlet 请 
求 时 ，servlet 把 请 求 封装 成 一 个 HttpServletRequest 
对 象 ， 然 后 把 对 象 传 给 servlet 的 对 应 的 服务 方法 。 


HTTP 的 请 求 方式 包括 delete、get、options、 
post、put 和 trace， 在 HttpServlet 类 中 分 别提 供 了 相 
应 的 服务 方法 ， 它 们 是 doDelete()、doGet()、 
doOptions()、doPost()、doPutO 和 doTrace()。 











11.3.1 servlet 的 使 用 


我 们 同样 还 是 以 最 简单 的 servlet 来 快速 体验 其 
用 法 。 


1. Œ servlet 





public class MyServlet extends HttpServlet{ 
public void init(){ 
System.out.println("this is init method"); 


j 


public void doGet(HttpServletRequest request, HttpServletR 
esponse response) { 
handleLogic 


(request, response); 
} 
public void doPost(HttpServletRequest request, HttpServlet 
Response response) { 
handleLogic 
(request, response); 
private void handleLogic(HttpServletRequest request, HttpS 
ervletResponse response) { 
System.out.println( "handle myLogic"); 


ServletContext sc = getServletContext(); 


RequestDispatcher rd = null; 





rd = sc.getRequestDispatcher("/index.jsp"); / / 5E (Fl 
的 页 面 
try { 
rd.forward(request, response); 
) catch (ServletException | IOException e) ( 
e.printStackTrace(); 
} 
} 
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法 和 get/post 方 法 的 处 理 ，init 方 法 保证 在 servlet 加 载 
的 时 候 能 做 一 些 逻 辑 操 作 ， 而 HttpServlet 类 则 会 帮 








助 我 们 根据 方法 类 型 的 不 同 而 将 逻辑 引入 不 同 的 函 
数 。 在 子 类 中 我 们 只 需要 重 写 对 应 的 函数 逻辑 便 
可 ， 如 以 上 代码 重 写 了 doGet 和 doPost 方 法 并 将 逻辑 


处 理 部 分 引导 至 handleLogic 函 数 中 ， 最 后 ， 又 将 页 
面 跳 转 至 ipdex.jsp。 


2， 读 加 配置 


为 了 使 servlet 能 够 正常 使 用 ， 需 要 在 web.xml 文 
件 中 添加 以 下 配置 : 


<servlet> 
<servlet -name>myservlet</servlet -name> 
<servlet-class>test.servlet .MyServlet</servlet-class> 
<load-on-startup>1</load-on-startup> 
</servlet> 


<servlet -mapping> 
<servlet -name>myservlet</servlet -name> 
<url-pattern>*.htm</url-pattern> 
</servlet -mapping> 





配置 后 便 可 以 根据 对 应 的 配置 访问 相应 的 路 径 








o 


11.3.2 DispatcherServleti1 27] 45 44, 


通过 上 面 的 实例 我 们 了 解 到 ， 在 servlet 初 始 化 
阶段 会 调用 其 init 方 法 ， 所 以 我 们 首先 要 得 看 在 
DispatcherServlet 中 是 否 重 写 了 init 方 法 。 我 们 在 其 
父 类 HttpServletBean 中 找到 了 该 方法 。 











public final void init() throws ServletException { 
if (logger.isDebugEnabled()) { 
logger.debug("Initializing servlet '" + getServlet 
Name ( ) + MS br 


try { 
// 解 析 init-param 并 封装 至 pvs 中 
PropertyValues pvs = new ServletConfigPropertyValu 





es 


(getServletConfig(), this.requiredProperties); 
// 将 当前 的 这 个 servlLet 类 转化 为 一 个 BeanWrapper, 从 而 能 够 以 Sprin 
g 的 方式 来 对 init-param 
// 的 值 进行 注入 
BeanWrapper bw = PropertyAccessorFactory.forBeanPr 
opertyAccess(this); 
ResourceLoader resourceLoader = new ServletContext 
ResourceLoader 
(getServletContext()); 
// 注 册 自 定义 属性 编辑 器 ， 一 旦 遇 到 Resource 类 型 的 属性 将 会 使 用 
ResourceEditor 进 行 解析 
bw.registerCustomEditor(Resource.class,new Resourc 
eEditor(resourceLoader, 
this.environment)); 
//*88C,. HER T 2TH hi 
initBeanWrapper (bw); 
// 属 性 注入 
bw.setPropertyValues(pvs, true); 






































catch (BeansException ex) ( 
logger.error("Failed to set bean properties on ser 
vlet '" + getServletName() + "'", ex); 
throw ex; 


j 


// 留 给 子 类 扩展 
initServletBean 





if (logger.isDebugEnabled()) { 
logger.debug("Servlet '" + getServletName() + "' c 


onfigured successfully"); 
} 
Í 








DipatcherServlet 的 初始 化 过 程 主要 是 通过 将 当 
前 的 servlet 类 型 实例 转换 为 BeanWrapper 类 型 实例 ， 
以 便 使 用 Spring 中 提供 的 注入 功能 进行 对 应 属性 的 
注入 。 这 些 属性 如 contextAttribute、 contextClass, 
nameSpace、contextConfigLocation 等 ， 都 可 以 在 





web.xml 文 件 中 以 初始 化 参数 的 方式 配置 在 servlet 的 
声明 中 。DispatcherServlet 继 承 目 

FrameworkServlet, FrameworkServlet 关 上 包含 对 应 
的 同名 属性 ，Spring 会 会 保证 这 些 参数 被 注入 到 对 应 
的 值 中 。 属 性 注入 主要 包含 以 下 几 个 步骤 。 





1. 封 疙 及 验证 初始 化 参数 


ServletConfigPropertyValues 除 了 封装 属性 外 还 
有 对 属性 验证 的 功能 。 





public ServletConfigPropertyValues(ServletConfig config, Set<St 
ring» requiredProperties) 
throws ServletException { 


Set<String> missingProps = (requiredProperties != 
null && !requiredProperties. isEmpty()) ? 


new HashSet<String>(requiredProperties) : 
null; 


Enumeration en = config.getInitParameterNames(); 


while (en.hasMoreElements()) ( 
String property - (String) en.nextElement(); 
Object value = config.getInitParameter(propert 


y); 
addPropertyValue(new PropertyValue(property, v 
alue)); 
if (missingProps != null) { 
missingProps.remove(property); 
} 
// Fail if we are still missing properties. 
if (missingProps != null && missingProps.size() > 
90) { 


throw new ServletException( 
"Initialization from ServletConfig for ser 
vlet '" + config.getServlet Name() + 
"' failed; the following required properti 
es were missing: " + 
StringUtils.collectionToDelimitedString(mi 
ssingProps, ", ")); 


j 





从 代码 中 得 知 ， 封 装 属性 主要 是 对 初始 化 的 参 
数 进行 封装 ， 也 就 是 servlet 中 配置 的 <init-param> 中 
配置 的 封装 。 当 然 ， 用 户 可 以 通过 对 
requiredProperties 参 数 的 初始 化 来 强制 验证 某 些 属 
性 的 必要 性 ， 这 样 ， 在 属性 封装 的 过 程 中 ， 一 旦 检 
测 到 requiredProperties 中 的 属性 没有 指定 初始 值 ， 
LA RS o 


2. 将 当前 servlet 实 例 转化 成 BeanWrapper 实 例 


PropertyAccessorFactory.forBeanPropertyAccess 


是 Spring 中 提供 的 工具 方法 ， 主 要 用 于 将 指定 实例 
转化 为 Spring 中 可 以 处 理 的 BeanWrapper 类 型 的 实 
例 。 





3. 注册 相对 于 Resource 的 属性 编辑 器 


属性 编辑 器 ， 我 们 在 上 文中 已 经 介绍 并 且 分 析 
过 其 原理 ， 这 里 使 用 属性 编辑 器 的 目的 是 在 对 当前 
实例 (DispatcherServlet) 属性 注入 过 程 中 一 旦 过 到 
Resource 类 型 的 属性 加 会 使 用 ResourceEditor 去 解 
析 。 


4. 属性 注入 


BeanWrapper 为 Spring 中 的 方法 ， 文 持 Spring 的 
目 动 注入 。 其 实 我 们 最 关 用 的 属性 注入 无 非 是 
contextAttribute 、contextClass、nameSpace、 


contextConfigLocation 等 。 





5. servletBean 的 初始 化 


在 ContextLoaderListener 加 载 的 时 候 已 经 创建 
了 WebApplicationContext 实 例 ， 而 在 这 个 函数 中 最 
重要 的 就 是 对 这 个 实例 进行 进一步 的 补充 初始 化 。 


继续 查看 initServletBean()。 父 类 
FrameworkServlet7¢ i. J HttpServletBean # [J 
initServletBeanPK Zi, YF: 





protected final void initServletBean() throws ServletException 


{ 


getServletContext().log("Initializing Spring Framework 


Servlet '" + getServlet Name() + "'"); 
if (this.logger.isInfoEnabled()) { 
this.logger.info("FrameworkServlet '" + getServlet 
Name()+ "': initialization started"); 
} 
long startTime = System.currentTimeMillis(); 
try { 
this.webApplicationContext - initWebApplicationCon 
text 
0; x 
// WA NFR 
initFrameworkServlet(); 
catch (ServletException ex) { 
this.logger.error("Context initialization failed", 
ex); 
throw ex; 
catch (RuntimeException ex) ( 
this.logger.error("Context initialization failed", 
ex); 
throw ex; 
} 
if (this.logger.isInfoEnabled()) { 
long elapsedTime = System.currentTimeMillis() - st 
artTime; 
this.logger.info("FrameworkServlet '" + getServlet 
Name() + "': 


initialization completed in " + 
elapsedTime + " ms"); 


j 


上 面 的 函数 设计 了 计时 需 来 统计 初始 化 的 执行 
时 间 ， 而 且 提 供 了 一 个 扩展 方法 
initFrameworkServletO 用 于 子 类 的 履 盖 操作 ， 而 作 
为 天 键 的 初始 化 远 辑 实现 委托 给 了 
initWebApplicationContext()。 


11.3.3 WebApplicationContext 的 初始 化 


initWebApplicationContext PK 20 A 3: Z T f E ze 
创建 或 刷新 WebApplicationContext 实 例 并 对 servlet 
功能 所 使 用 的 变量 进行 初始 化 。 





Protected WebApplicationContext initWebApplicationContext() { 
WebApplicationContext rootContext - 
WebApplicationContextUtils.getWebApplicationCo 
ntext(getServletContext()); 
WebApplicationContext wac - null; 


if (this.webApplicationContext !- null) ( 
//context 实 例 在 构造 函数 中 被 注入 
wac = this.webApplicationContext; 
if (wac instanceof ConfigurablewebApplicationConte 
xt) { 
ConfigurablewebApplicationContext cwac = (Conf 
igurableWebApplication 
Context) wac; 
if (!cwac.isActive()) { 


if (cwac.getParent() == null) { 
cwac.setParent(rootContext); 


j 


// 刷 新 上 下 文 环境 
configureAndRefreshWebApplicationContext 


(cwac); 


if (wac == null) { 
// 根 据 contextAttribute 属 性 加 载 WebpApp1LicationCcontext 
wac = findwebApplicationContext 





} 
if (wac == null) { 
// No context instance is defined for this servlet 
-> create a local one 
wac = createWebApplicationContext 


(rootContext); 


if (!this.refreshEventReceived) ( 
// Either the context is not a ConfigurableApplica 
tionContext with refresh 


// support or the context injected at construction 
time had already been 
// refreshed -> trigger initial onRefresh manually 


here. 
onRefresh 
(wac); 
if (this.publishContext) { 
// Publish the context as a servlet context attrib 
ute. 


String attrName = getServletContextAttributeName() 


getServletContext().setAttribute(attrName, wac); 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Published WebApplicationCon 
text of servlet '" + 
getServletName() + 
"' as ServletContext attribute with na 


me [" + attrName + "]"); 


} 


return wac; 





对 于 本 函数 中 的 初始 化 主要 包含 几 个 部 分 。 


1. 寻找 或 创建 对 应 的 WebApplicationContext 实 例 


WebApplicationContext 的 寻找 及 创建 包括 以 下 
JV ER 


过 构造 函数 的 注入 进行 初始 化 。 


1A Wt AinitWebA pplicationContext EK Zi Jr;388 3E Fl] 
IBrthis.webApplicationContext != nul 后 ， 便 可 以 确定 
this.webApplicationContext 是 否 是 通过 构造 函数 来 初 
始 化 的 。 可 是 有 读者 可 能 会 有 疑问 ， 在 
initServletBean 函 数 中 明明 是 把 创建 好 的 实例 记录 在 
J 了 this.webApplicationContext 中 : 








this.webApplicationContext- initWebApplicationContext(); 





fe] DAE RTS SCE BR SC S Ms Ti 
不 是 通过 上 一 次 的 函数 返回 值 初 始 化 呢 ? 如 果 存 在 





x^ ug. JA GLA NE HE I: 在 Web 
中 包含 SpringWeb 的 核心 逻辑 的 DispatcherServlet 只 
可 以 被 声明 为 一 次 ， 在 Spring 中 已 经 存在 验证 ， 所 
以 这 就 确保 了 如 果 this.webApplicationContext != 
null， 则 可 以 直接 判定 this.webApplicationContext 已 
经 通过 构造 函数 初始 化 。 


2. 通过 contextAttribute 进 行 初始 化 。 


人 通过 在 web.xml 文 件 中 配置 的 servlet 参 数 
contextAttribute 来 查找 ServletContext 中 对 应 的 属 
lE, SUAZJWebApplicationContext.class.getName() 
+" ROOT", 153b Xe 1EContextLoaderListenerII X E] 
会 创建 WebApplicationContext 实 例 ， 并 将 实例 以 
WebApplicationContext.class.getName() + 
"ROOT'" 为 key 放 入 ServletContext 中 ， 当 然 读者 可 以 
重 写 初 始 化 馆 辑 使 用 自己 创建 的 
WebApplicationContext， 并 在 servlet 的 配置 中 通过 
初始 化 参数 contextAttribute 指 定 key。 











protected WebApplicationContext findwebApplicationContext() { 
String attrName = getContextAttribute(); 
if (attrName == null) { 
return null; 


WebApplicationContext wac = 
WebApplicationContextUtils.getwebApplicationCo 
ntext(getServletContext(), attrName); 
if (wac -- null) ( 
throw new IllegalStateException("No WebApplication 
Context found: initializer 


not registered?"); 


return wac; 





3. 重新 创建 WebApplicationContext 实 例 。 


如 条 通过 以 上 两 种 方式 并 没有 找到 任何 突破 ， 
那 束 没 办 法 了 ， 只 能 在 这 里 重新 创建 新 的 实例 了 。 





protected WebApplicationContext createWebApplicationContext (Web 
ApplicationContext parent) { 
return createWebApplicationContext 


((ApplicationContext) parent); 
} 


protected WebApplicationContext createWebApplicationContext(App 
licationContext parent) { 
// 获 取 servlet 的 初始 化 参数 contextCclass，, 如 果 没 有 配置 默认 为 XmlwebAp 
plicationContext.class 
Class<?> contextClass = getContextClass(); 
if (this.logger.isDebugEnabled()) { 
this.logger.debug("Servlet with name '" + getServl 




















etName() + 

"' will try to create custom WebApplicatio 
nContext context of class '" + 

contextClass.getName() + "'" + ", using pa 
rent context [" + parent + "]"); 


if (!ConfigurableWebApplicationContext.class.isAssigna 
bleFrom(contextClass)) { 
throw new ApplicationContextException( 

"Fatal initialization error in servlet wit 
h name '" + getServletName() + 

"'i custom WebApplicationContext class [" 
+ contextClass.getName() + 

"] is not of type ConfigurableWebApplicati 
onContext"); 


j 


// 通 过 反射 方式 实例 化 contextClass 

ConfigurablewebApplicationContext wac = 

(ConfigurableWebApplicationContext) BeanUtils. 

instantiateClass 
(contextClass); 
//parent 为 在 ContextLoaderListener 中 创建 的 实例 

// 在 ContextLoaderListener 加 载 的 时 候 初 始 化 的 WebApplicationc 
ontext 类 型 实例 

wac.setParent(parent); 

// 获 取 contextconfigLocation 属 性 ， 配 置 在 servlet 初 始 化 参数 中 
wac.setConfigLocation(getContextConfigLocation()); 
// 初 始 化 Spring 环境 包括 加 载 配置 文件 等 

configureAndRefreshWebApplicationContext(wac); 








return wac; 





2. configureAndRefreshWebApplicationContext 


无 论 是 通过 构造 水 数 注入 还 是 单独 创建 ， 都 会 
调用 configureAndRefreshWebApplicationContext 方 
法 来 对 已 经 创建 的 WebApplicationContext 实 例 进 行 
配置 及 刷新 ， 那 么 这 个 步骤 又 做 了 哪些 工作 呢 ? 





protected void configureAndRefreshWebApplicationContext(Configu 
rablewebApplication Context wac, ServletContext sc) { 
if (ObjectUtils.identityToString(wac).equals(wac.getId 


(23) 1 

// The application context id is still set to its 
original default value 

// -» assign a more useful id based on available i 
nformation 

String idParam = sc.getlInitParameter(CONTEXT ID PA 
RAM); 

if (idParam != null) { 

wac.setId(idParam) ; 


} 
else ( 
// Generate default id... 
if (sc.getMajorVersion() -- 2 && sc.getMinorVe 
rsion() « 5) ( 
// Servlet «- 2.4: resort to name specifie 
d in web.xml, if any. 
wac.setId(ConfigurablewebApplicationContex 
t.APPLICATION_ CONTEXT_ 
ID_PREFIX + 
ObjectUtils.getDisplayString(sc.ge 
tServletContextName())); 
} 
else ( 
wac.setId(ConfigurablewebApplicationContex 
t.APPLICATION_CONTEXT_ ID_PREFIX + 
ObjectUtils.getDisplayString(sc.ge 
tContextPath())); 


j 
} 


// Determine parent for root web application context, 
if any. 
ApplicationContext parent = loadParentContext(sc); 


wac.setParent(parent); 

wac.setServletContext(sc); 

String initParameter - sc.getInitParameter(CONFIG LOCA 
TION PARAM); 

if (initParameter !- null) { 

wac.setConfigLocation(initParameter); 

} 

customizeContext(sc, wac); 
/V/ 加 载 配 置 文件 及 整合 parent 到 wac 

wac.refresh(); 




















无 论调 用 方式 如 何 变化 ， 只 要 是 使 用 


AlicationContext 所 提供 的 功能 最 后 都 免不了 使 用 公 


共 父 类 AbstractApplicationContext 提 供 的 refreshO 进 


行 配置 文件 加 载 。 
3. 刷新 


onRefresh 是 FrameworkServlet 类 中 提供 的 模板 
方法 ， 在 其 子 类 DispatcherServlet 中 进行 了 重 写 ， 主 
要 用 于 刷新 Spring 在 Web 功 能 实现 中 所 必须 使 用 的 
全 局 变量 。 下 面 我 们 会 介绍 它们 的 初始 化 过 程 以 及 
使 用 场景 ， 而 至 于 县 体 的 使 用 细节 会 在 稍 后 的 章节 
中 再 做 详细 介绍 。 





protected void onRefresh(ApplicationContext context) { 
initStrategies 


(context); 


j 


protected void initStrategies(ApplicationContext context) { 
// (41) 初始化 MultipartResolver 
initMultipartResolver(context); 


//(2) 初 始 化 LocaleResolver 
initLocaleResolver(context); 


//(3) 初 始 化 ThemeResolver 
initThemeResolver(context); 


// (4) 8]*& f HandlerMappings 
initHandlerMappings(context); 


//(5) 初 始 化 HandlerAdapters 
initHandlerAdapters(context); 


// (6) ]*G64 HandlerExceptionResolvers 
initHandlerExceptionResolvers(context); 


// (T Wat, RequestToViewNameTranslator 
initRequestToViewNameTranslator(context); 


//(8) 初 始 化 ViewResolvers 
initViewResolvers(context); 


// (9) 'À*&15FlashMapManager 
initFlashMapManager (context); 





1. 初始 化 MultipartResolver。 


在 Spring 中 ，MultipartResolver 主 要 用 来 处 理 文 
件 上 传 。 上 默认 情况 下 ，Spring 是 没有 multipart 处 理 
的 ， 因 为 一 些 开 发 者 想 要 自己 处 理 它们 。 如 果 想 使 
用 Spring 的 multipart， 则 需要 在 Web 应 用 的 上 下 文中 
添加 multipart 解 析 右 。 这 样 ， 每 个 请 求 束 会 被 检查 
是 否 包 含 multipart。 然 而 ， 如 果 请 求 中 包含 
multipart， 那 么 上 下 文中 定义 的 MultipartResolver 束 
会 解析 它 ， 这 样 请 求 中 的 multipart 属 性 就 会 像 其 他 
属性 一 样 被 处 理 。 常 用 配置 如 下 : 








«bean id-"multipartResolver" class="org.Springframework.web.mul 
tipart.commons. Commons MultipartResolver'-» 
«1-- 该 属性 用 来 配置 可 上 传 文件 的 最 大 字 节 数 --> 


«property name="maximumFileSize"><value>100000</value></propert 

















y» 
«/bean» 





当然 ，CommonsMultipartResolver 还 提供 了 其 
他 功能 用 于 帮助 用 户 完 成 上 传 功 能 ， 有 兴趣 的 读者 
可 以 进一步 得 看 。 








那么 MultipartResolver 就 是 在 
initMultipartResolver 中 被 加 入 到 DispatcherServlet 中 
的 。 





private void initMultipartResolver(ApplicationContext context) 


1 


try { 
this.multipartResolver - context.getBean(MULTIPART 
. RESOLVER BEAN NAME, 
MultipartResolver.class); 
if (logger.isDebugEnabled()) (1 
logger.debug("Using MultipartResolver [" + thi 
s.multipartResolver + "]"); 


catch (NoSuchBeanDefinitionException ex) { 
// Default is no multipart resolver. 
this.multipartResolver - null; 
if (logger.isDebugEnabled()) (1 
logger.debug("Unable to locate MultipartResolv 
er with name '" + 
MULTIPART RESOLVER BEAN NAME + 
"': no multipart request handling prov 
ided"); 


| 

为 之 前 的 步骤 已 经 完成 了 Spring 中 配置 文件 
的 解析 ， 所 以 在 这 里 只 要 在 配置 文件 注册 过 都 可 以 
通过 ApplicationContext 提 供 的 getBean 方 法 来 直接 获 
取 对 应 bean， 进 而 初始 化 MultipartResolver 中 的 


multipartResolver 变 量 。 








2. 初始 化 LocaleResolver。 
在 Spring 的 国际 化 配置 中 一 共有 3 种 使 用 方式 。 
。 其 于 URL 参 数 的 配置 。 


通过 URL 参 数 来 控制 国际 化 ， 比 如 你 在 页 面 上 
加 一 句 <a href="?locale=zh_CN"> 简 体 中 文 </a> 来 控 
制 项 目 中 使 用 的 国际 化 参数 。 而 提供 这 个 功能 的 就 
是 AcceptHeaderLocaleResolver， 默 认 的 参数 名 为 
locale， 注 意 大 小 写 。 里 耐 放 的 束 是 你 的 提交 参 
数 ， 比 如 en_US、zh_CN 之 类 的 ， 具 体 配 置 如 下 ; 

















«bean id-"localeResolver" class="org.Springframework.web.servle 
t.i18n. AcceptHeader LocaleResolver"/» 





。 基 于 session 的 配置 。 


Ean mh RC PRECES Js PER RAS DX 
域 。 最 妆 用 的 是 根据 用 户 本 次 会 话 过 程 中 的 语言 设 
定 决 定语 言 种 类 (例如 ， 用 户 登 录 时 选择 语言 种 
类 ， 则 此 次 登录 周期 内 统一 使 用 此 语言 设 定 〉)， 如 
果 该 会 话 属性 不 存在 ， 它 会 根据 accept-language 
HTTP 汰 部 人 确定 默认 区 域 。 


























«bean id-"localeResolver" class="org.Springframework.web.servle 
t.i18n.SessionLocaleResolver"/> 





。 基 于 cookie 的 国际 化 配置 。 


CookieLocaleResolver 用 于 通过 浏览 器 的 cookie 
设置 取得 Locale 对 象 。 这 种 案 略 在 应 用 程序 个 文 持 
会 话 或 者 状态 必须 保存 在 客户 端 时 有 用 ， 配 置 如 
下 : 














«bean id-"localeResolver" class="org.Springframework.web.servle 
t.i18n.CookieLocaleResolver"/» 





这 3 种 方式 都 可 以 解决 国际 化 的 问题 ， 但 是 ， 
对 于 LocalResolver 的 使 用 基础 是 在 DispatcherServlet 
中 的 初始 化 。 





private void initLocaleResolver(ApplicationContext context) { 
try { 
this.localeResolver = context.getBean(LOCALE RESOL 
VER BEAN NAME, Locale Resolver.class); 


if (logger.isDebugEnabled()) { 
logger .debug( "Using LocaleResolver [" + this.l 
ocaleResolver + "]"); 


j 


catch (NoSuchBeanDefinitionException ex) { 
// We need to use the default. 
this.localeResolver = getDefaultStrategy(context, 
LocaleResolver.class); 
if (logger.isDebugEnabled()) { 
logger .debug( "Unable to locate LocaleResolver 
with name '" + LOCALE_ 
RESOLVER_BEAN_NAME + 
"': using default [" + this.localeReso 
lver + "]"); 
} 
} 





提取 配置 文件 中 设置 的 LocaleResolver 来 初始 
化 DispatcherServlet 中 的 localeResolver 属 性 。 


3. 初始 化 ThemeResolver。 


在 Web 开 发 中 经 各 会 遇 到 通过 主题 Theme 来 控 
制 网 页 风格 ， 这 将 进一步 改善 用 户 体 验 。 人 简单 地 
说 ， 一 个 主题 束 是 一 组 静态 资源 (比如 样式 表 和 图 
片 )， 它 们 可 以 影 啊 应 用 程序 的 视 放 效果 。Spring 
中 的 主题 功能 和 国际 化 功能 非常 类 似 。Spring 主 题 
功能 的 构成 主要 包括 如 下 内 容 。 


y 


。 主题 资源 。 











org.Springframework.ui.context. ThemeSource x 
Spring 中 主题 资源 的 接口 ，Spring 的 主题 需要 通过 
ThemeSource 接 口 来 实现 存放 主题 信息 的 资源 。 











org.Springframework.ui.context.support.Resourcel 
是 ThemeSource 接 口上 默认 实现 类 (也 束 是 通过 
ResourceBundle 资 源 的 方式 定义 主题 ) ， 在 Spring 中 
的 配置 如 下 : 








«bean id="themeSource" class-'org.Springframework.ui.context.su 
pport.ResourceBundle 
ThemeSource"> 


<property name="basenamePrefix" value="com.test. "></property> 
</bean> 








默认 状态 下 是 在 类 路 径 根 目录 下 但 找 相 应 的 资 
源 文 件 ， 也 可 以 通过 basenamePrefix 来 制定 。 这 
样 ，DispatcherServlet 残 会 在 com.test 包 下 三 找 资源 
X fF. 


IESU EE 


ThemeSource 定 义 了 一 些 主题 资源 ， 那 么 不 同 
的 用 户 使 用 什么 主题 资源 由 谁 定 义 呢 ? 
org.Springframework.web.servlet. ThemeResolverZé + 
2 m 口 ， 主 题解 析 的 工作 便 由 它 的 子 类 来 
7Uü HXio 


对 于 主题 解析 器 的 子 类 主要 有 3 个 比较 弟 用 的 
实现 。 以 主题 文件 summer.properties 为 例 。 


(D FixedThemeResolver 用 于 选择 一 个 固定 的 主 
题 。 


«bean id="themeResolver" class="org.Springframework.web.servlet 
.theme.FixedTheme Resolver"- 
«property name-"defaultThemeName" value="Summer"/> 


«/bean» 








以 上 配置 的 作用 是 设置 主题 文件 为 
summer.properties， 在 整个 项 目 内 固定 不 变 。 





(2) CookieThemeResolver 用 于 实现 用 户 所 选 的 
主题 ， 以 cookie 的 形式 存放 在 客户 端的 机 器 上 ， 配 
置 如 下 : 





«bean id="themeResolver" class="org.Springframework.web.servlet 
. theme.CookieThemeResolver'"> 
«property name="defaultThemeName" value="Summer"/> 


</bean> 





(8) SessionThemeResolver 用 于 主题 保存 在 用 户 
HJHTTP Session 。 





«bean id="themeResolver" class="org.Springframework.web.servlet 
. theme.SessionThemeResolver"> 

«property name="defaultThemeName" value="Summer"/> 

</bean> 


———— 9i 


以 上 配置 用 于 设置 主题 名 称 ， 并 且 将 该 名 称 保 
存在 用 户 的 HttpSession 中 。 








(4) AbstractThemeResolver 是 一 个 抽象 类 被 
SessionThemeResolver4llFixedThemeResolverZ*;K , 
用 户 也 可 以 继承 它 来 自 定 义 主题 解析 器 。 

e T. 
如 果 需 要 根据 用 户 请 求 来 改变 主题 ， 那 么 


Spring 提供 了 一 个 已 经 实现 的 拦截 器 一 Theme 
ChangelInterceptor 拦 截 器 了， 配置 如 下 : 








«bean id="themeChangeInterceptor" class="org.Springframework.we 
b.servlet.theme. Theme ChangeInterceptor'"> 


«property name-"paramName" value="themeName"></property> 
</bean> 








其 中 设置 用 户 请 求 参 数 名 为 hemeName， 即 
URL 为 ?themeName= 具 体 的 主题 名 称 。 此 外 ， 还 需 
要 在 handlerMapping 中 配置 拦截 器 。 当 然 需要 在 
HandleMapping P 25 JE E ds o 





«property name="interceptors"> 
«list» 


«ref local="themeChangeInterceptor" /> 
</list> 
</property> 


MEM 


了 解 了 主题 文件 的 简单 使 用 方式 后 ， 再 来 得 看 
解析 避 的 初始 化 工作 ， 与 其 他 变量 的 初始 化 工作 相 
同 ， 主 题 文 件 解析 强 的 初始 化 工作 并 没有 任何 证 要 
特别 说 明 的 地 方 。 








private void initThemeResolver(ApplicationContext context) 
{ 
try { 

this.themeResolver = context.getBean(THEME RESOLVE 
R BEAN NAME, ThemeResolver. class); 

if (logger.isDebugEnabled()) (1 

logger.debug("Using ThemeResolver [" + this.th 

emeResolver + "]"); 


J 


catch (NoSuchBeanDefinitionException ex) { 
// We need to use the default. 
this.themeResolver = getDefaultStrategy(context, T 
hemeResolver.class); 
if (logger.isDebugEnabled()) { 
logger .debug( 
"Unable to locate ThemeResolver with n 


ame '" + THEME_ RESOLVER_ BEAN_NAME + "': using default [" + 
this.themeResolver + "]"); 





4. 初始 化 HandlerMappings。 


当 客 户 端 发 出 Request 时 DispatcherServlet 会 将 
Redquest 提 交 给 HandlerMapping， 然 后 
HanlerMapping 根 据 Web Application Context 的 配置 


来 回 传 给 DispatcherServlet 相 应 的 Controller。 


在 基于 SpringMVC 的 Web 应 用 程序 中 ， 我 们 可 
以 为 DispatcherServlet 提 供 多 个 Handler Mapping 供 其 
使 用 。DispatcherServlet 在 选用 HandlerMapping 的 过 
程 中 ， 将 根据 我 们 所 指定 的 一 系列 HandlerMapping 
的 优先 级 进行 排序 ， 然 后 优先 使 用 优先 级 在 前 的 
HandlerMapping。 如 果 当 前 的 HandlerMapping 能 够 
返回 可 用 的 Handler，DispatcherServlet 则 使 用 当前 
返回 的 Handler 进 行 Web 请 求 的 处 理 ， 而 不 再 继续 询 
问 其 他 的 HandlerMapping。 人 否则 ，DispatcherServlet 
将 继续 按照 各 个 HandlerMapping 的 优先 级 进行 询 
问 ， 直 到 获取 一 个 可 用 的 Handler 为 止 。 初 始 化 配置 
如 下 : 











private void initHandlerMappings(ApplicationContext context) { 
this.handlerMappings = null; 


if (this.detectAllHandlerMappings) { 


Map<String, HandlerMapping> matchingBeans = 
BeanFactoryUtils.beansOfTypelIncludingAnces 
tors(context, 
HandlerMapping. class, true, false); 
if (!matchingBeans.isEmpty()) { 
this.handlerMappings - new ArrayList«HandlerMa 
pping» (matchingBeans. values()); 
// We keep HandlerMappings in sorted order. 
OrderComparator.sort(this.handlerMappings); 


HandlerMapping hm - context.getBean(HANDLER MA 


PPING BEAN NAME, 
HandlerMapping.class); 
this.handlerMappings = Collections.singletonLi 


st(hm); 
catch (NoSuchBeanDefinitionException ex) { 
// Ignore, we'll add a default HandlerMapping 
later. 
} 
} 
// Ensure we have at least one HandlerMapping, by regi 
stering 
// a default HandlerMapping if no other mappings are f 
ound. 


if (this.handlerMappings == null) { 
this.handlerMappings - getDefaultStrategies(contex 
t, HandlerMapping.class); 
if (logger.isDebugEnabled()) (1 
logger.debug("No HandlerMappings found in serv 
let '" + getServletName() + "': using default"); 


j 





默认 情况 下 ，SpringMVC 将 加 载 当前 系统 中 所 
有 实现 了 HandlerMapping 接 口 的 bean。 如 果 只 期 望 
SpringMVC 加 载 指定 的 handlermapping 时 ， 可 以 修 
改 web.xml 中 的 DispatcherServlet 的 初始 参数 ， 将 
detectAll]HandlerMappings 的 值 设 置 为 false: 


<init -param> 
<param-name>detectAllHandlerMappings</param-name> 
<param-value>false</param-value> 


</init -param> 





此 时 ，SpringMVC 将 查找 名 
为 “<handlerMapping” 的 bean， 并 作为 当前 系统 中 唯 
一 的 handlermapping。 如 果 没 有 定义 handlerMapping 
的 话 ， 则 SpringMVC 将 按照 org.Springframework. 
web.servlet.DispatcherServlet 所 在 目录 下 的 
DispatcherServlet.properties 中 所 定义 的 
org.Springframework. web.servlet.HandlerMapping 的 
内 容 来 加 载 默认 的 handlerMapping (用 户 没 有 目 定 
义 Strategies 的 情况 下 ) 。 





5. 初始 化 HandlerAdapters。 


从 名 字 也 能 联想 到 这 是 一 个 典型 的 适 配 右 模式 
的 使 用 ， 在 计算 机 编程 中 ， 适 配器 模式 将 一 个 类 的 
接口 适 配 成 用 户 所 期 竺 的。 使 用 适配器 ， 可 以 使 接 
口 不 兼容 而 无 法 在 一 起 工作 的 类 协同 工作 ， 做 法 是 
将 类 自己 的 接口 包 于 在 一 个 已 存在 的 类 中 。 那 么 在 
处 理 handler 时 为 什么 会 使 用 适配器 模式 呢 ? 回答 这 
个 问题 我 们 首先 要 分 析 它 的 初始 化 逻辑 。 














private void initHandlerAdapters(ApplicationContext context) { 
this.handlerAdapters - null; 


if (this.detectAllHandlerAdapters) ( 
// Find all HandlerAdapters in the ApplicationCont 
ext, including ancestor contexts. 
Map<String, HandlerAdapter» matchingBeans = 
BeanFactoryUtils.beansOfTypelIncludingAnces 
tors(context, HandlerAdapter. class, true, false); 
if (!matchingBeans.isEmpty()) { 
this.handlerAdapters - new ArrayList«HandlerAd 


apter>(matchingBeans. 
values()); 
// We keep HandlerAdapters in sorted order. 
OrderComparator.sort(this.handlerAdapters); 
} 
} 
else ( 
try { 
HandlerAdapter ha - context.getBean(HANDLER AD 
APTER BEAN NAME, 
HandlerAdapter.class); 
this.handlerAdapters = Collections.singletonLi 
st(ha); 


catch (NoSuchBeanDefinitionException ex) { 
// Tgnore, we'll add a default HandlerAdapter 
later. 


// Ensure we have at least some HandlerAdapters, by re 
gistering 
// default HandlerAdapters if no other adapters are fo 
und. 
if (this.handlerAdapters == null) { 
this.handlerAdapters = getDefaultStrategies 


(context, HandlerAdapter.class); 
if (logger.isDebugEnabled()) { 
logger.debug("No HandlerAdapters found in serv 
let '" + getServletName() + "': using default"); 


j 





同样 在 初始 化 的 过 程 中 涉及 了 一 个 变量 
detectAllHandlerAdapters, detectAllHandlerAdapters 
作用 和 detectAllHandlerMappings 类 似 ， 只 不 过 作用 
对 象 为 handlerAdapter。 亦 可 通过 如 下 配置 来 强制 系 


统 只 加 载 bean name 
为 “handlerAdapter”handlerAdapter。 


<init-param> 
<param-name>detectAllHandlerAdapters</param-name> 
<param-value>false</param-value> 


</init-param> 





如 果 无 法 找到 对 应 的 bean， 那 么 系统 会 尝试 加 
载 默认 的 适配器 。 


protected «T» List<T> getDefaultStrategies(ApplicationContext c 
ontext, Class<T> 
strategyInterface) { 
String key = strategyInterface.getName( ); 
String value - defaultStrategies.getProperty(key); 
if (value !- null) { 
String[] classNames = StringUtils.commaDelimitedLi 
stToStringArray(value); 
List<T> strategies = new ArrayList<T>(classNames.1 





ength); 
for (String className : classNames) { 
try { 

Class<?> clazz = ClassUtils.forName(classN 
ame, DispatcherServlet. class.getClassLoader()); 

Object strategy - createDefaultStrategy(co 
ntext, clazz); 

strategies.add((T) strategy); 


catch (ClassNotFoundException ex) { 
throw new BeanInitializationException( 
"Could not find DispatcherServlet' 
s default strategy class [" + className + 
"] for interface [" + key 
mum 


catch (LinkageError err) ( 
throw new BeanInitializationException( 
"Error loading DispatcherServlet's 


default strategy class [" + className + 


"] for interface [" + key 
+"]: problem with class file or dependent class", err); 


j 
j 
return strategies; 
j 
else ( 
return new LinkedList<T>(); 
j 





#£ getDefaultStrategies rx Zt rH, Springa ZAM 
defaultStrategies 中 加 载 对 应 的 HandlerAdapter 的 属 
性 ， 那 么 defaultStrategies 是 如 何 初始 化 的 呢 ? 


在 当前 类 DispatcherServlet 中 存在 这 样 一 段 初 始 
化 代码 块 : 


static ( 
try { 
// DEFAULT STRATEGIES PATH - "DispatcherServlet.pr 
operties"; 
ClassPathResource resource - new ClassPathResource 
(DEFAULT STRATEGIES PATH, DispatcherServlet.class); 


defaultStrategies - PropertiesLoaderUtils.loadProp 
erties(resource); 


catch (IOException ex) { 
throw new IllegalStateException("Could not load 'D 
ispatcher Servlet. 
properties': " + ex.getMessage( )); 


j 
} 








在 系统 加 载 的 时 候 ，defaultStrategies 根 据 当 前 


路 径 DispatcherServlet.properties 来 初始 化 本 身 ， 碍 
看 DispatcherServlet.properties 中 对 应 于 
HandlerAdapter 的 属性 : 


org.Springframework.web.servlet.HandlerAdapter-org.Springframew 

ork.web.servlet.mvc.HttpRequestHandlerAdapter, \ 
org.Springframework.web.servlet.mvc.SimpleControllerHandle 

rAdapter, \ 
org.Springframework.web.servlet.mvc.annotation.AnnotationM 


ethodHandlerAdapter 





由 此 得 知 ， 如 果 程 序 开发 人 员 没 有 在 配置 文件 
中 定义 目 己 的 适 配 副 ， 那 么 Spring 会 默认 加 载 配 置 
文件 中 的 3 个 适配器 。 


作为 总 控制 器 的 派遣 器 servlet 通 过 处 理 器 映 冉 
得 到 处 理 嚣 后， 会 轮 询 处 理 絮 适配器 模块 ， 查 找 能 
够 处 理 当 前 HTTP 请 求 的 处 理 器 适 配 右 的 实现 ， 处 
理 器 适配器 模块 根据 处 理 器 映射 返回 的 处 理 器 类 
型 ， 例 如 简单 的 控制 器 类 型 、 注 解 控制 器 类 型 或 者 
远程 调用 处 理 器 类 型 ， 来 选择 某 一 个 适当 的 人 处理 器 
适 配 右 的 实现 ， 从 而 适 配 当 前 的 HTTP 请 求 。 


e HTTP KADE sis Rods 
(HttpRequestHandlerAdapter) . 


HTTP 请 求 处 理 器 适配器 仅仅 文 持 对 HTTP 请 求 
处 理 器 的 适 配 。 它 简单 地 将 HTTP 请 求 对 象 和 响应 











对 象 传递 给 HITP 请 求 处 理 器 的 实现 ， 它 并 不 需要 
返回 值 。 它 主要 应 用 在 基于 HTTP 的 远程 调用 的 实 
现 上 。 


o faj EEFE I Ar Ah E Ar E A 
(SimpleControllerHandlerAdapter) . 


这 个 实现 类 将 HTTP 请 求 适 配 到 一 个 控制 器 的 
实现 进行 处 理 。 这 里 控制 器 的 实现 是 一 个 简单 的 控 
制 器 接口 的 实现 。 简 单 控 制 器 处 理 器 适配器 被 设计 
成 一 个 框架 类 的 实现 ， 不 需要 被 改 瑟 ， 客 户 化 的 业 
务 逻 辑 通 常 是 在 控制 器 接口 的 实现 类 中 实现 的 。 


。 注 解 方法 处 理 需 适 配 需 
CAnnotationMethodHandlerAdapter) . 


这 个 类 的 实现 是 基于 注解 的 实现 ， 它 需要 结合 
注解 方法 映射 和 注解 方法 处 理 器 协同 工作 。 它 通过 
解析 声明 在 注解 控制 器 的 请 求 映 射 信 息 来 解析 相应 
的 处 理 需 方法 来 处 理 当 前 的 HTTP 请求。 在 处 理 的 
过 程 中 ， 它 通过 反射 来 上 友 现 探测 处 理 需 方法 的 参 
数 ， 调 用 处 理 需 方法 ， 并 用 映射 返回 值 到 模型 和 控 
制 嚣 对象， 最 后 返回 模型 和 控制 器 对 象 给 作为 主 控 
jill as AV te 4 Servlet. 


所 以 我 们 现在 基本 上 可 以 回答 之 前 的 问题 了 ， 

















Spring 中 所 使 用 的 Handler 并 没有 任何 特殊 的 联系 ， 
但 是 为 了 统一 处 理 ，Spring 提 供 了 不 同情 况 下 的 适 
BC AE © 





6. 初始 化 HandlerExceptionResolvers。 


3 F HandlerExceptionResolver#2 O Hy) FF Fy Ab 
理 ， 使 用 这 种 方式 只 需要 实现 resolveException 方 
法 ， 该 方法 返回 一 个 ModelAndView 对 象 ， 在 方法 
内 部 对 异 和 党 的 类 型 进行 判断 ， 然 后 尝试 生成 对 应 的 
ModelAndView 对 象 ， 如 果 该 方法 返回 了 null， 则 
Spring 会 继续 寻找 其 他 的 实现 了 
HandlerExceptionResolver 接 口 的 bean。 换 句 话 说 ， 
Spring 会 搜索 所 有 注册 在 其 环境 中 的 实现 了 
HandlerExceptionResolver 接 口 的 bean， 逐 个 执行 ， 
直到 返回 了 一 个 ModelAndView 对 象 。 








import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 


import org.apache.commons.logging.Log; 

import org.apache.commons.logging.LogFactory; 

import org.Springframework.stereotype.Component; 

import org.Springframework.web.servlet.HandlerExceptionResolver 


了 
import org.Springframework.web.servlet.ModelAndView; 


@Component 
public class ExceptionHandler implements HandlerExceptionResolv 
er 
{ 

private static final Log logs = LogFactory.getLog(Exception 
Handler.class); 


@Override 
public ModelAndView resolveException(HttpServletRequest req 
uest, HttpServletResponse response, Object obj, 
Exception exception) 


{ 
request.setAttribute("exception", exception.toString()) 
/ 
request.setAttribute("exceptionStack", exception); 
logs.error(exception.toString(), exception); 
return new ModelAndView("error/exception"); 
} 





这 个 类 必须 声明 到 Spring 中 去 ， 让 Spring 管理 
它 ， 在 Spring 的 配置 文件 applicationContext.xml 中 增 
加 以 下 内 容 : 


«bean id="exceptionHandler" class="com.test.exception.MyExcepti 
onHandler"/» 





初始 化 代码 如 下 : 





private void initHandlerExceptionResolvers(ApplicationContext c 
ontext) { 
this.handlerExceptionResolvers - null; 


if (this.detectAllHandlerExceptionResolvers) { 

// Find all HandlerExceptionResolvers in the Appli 
cationContext, including 
ancestor contexts. 

Map<String, HandlerExceptionResolver» matchingBean 
s = BeanFactoryUtils 

.beansOfTypeIncludingAncestors(context, Ha 

ndlerExceptionResolver. 
class, true, false); 


if (!matchingBeans.isEmpty()) ( 

this.handlerExceptionResolvers - new ArrayList 
«Handler Exception 
Resolver»(matchingBeans.values()); 

// We keep HandlerExceptionResolvers in sorted 
order. 

OrderComparator.sort(this.handlerExceptionReso 
lvers); 


j 


else ( 
try { 
HandlerExceptionResolver her - 
context.getBean(HANDLER EXCEPTION RESO 
LVER BEAN NAME, HandlerExceptionResolver.class); 
this.handlerExceptionResolvers - Collections.s 
ingletonList(her); 


catch (NoSuchBeanDefinitionException ex) { 
// Ignore, no HandlerExceptionResolver is fine 
too. 


// Ensure we have at least some HandlerExceptionResolv 
ers, by registering 
// default HandlerExceptionResolvers if no other resol 
vers are found. 
if (this.handlerExceptionResolvers == null) { 
this.handlerExceptionResolvers = getDefaultStrateg 
ies(context, Handler 
ExceptionResolver.class); 
if (logger.isDebugEnabled()) (1 
logger.debug("No HandlerExceptionResolvers fou 
nd in servlet '" + 
getServletName() + "': using default"); 


j 
j 





7. 初始 化 RequestToViewNameTranslator。 


X Controller Ab H 23 77 14:15:44 3& |B] — 4] View Xt 
象 或 逻辑 视图 名 称 ， 并 且 在 该 方法 中 没有 直接 往 
response 的 输出 流 里 面 写 数据 的 时 候 ，Spring 束 会 采 
用 约定 好 的 方式 提供 一 个 逻辑 视图 名 称 。 这 个 好 辑 
视图 名 称 是 通过 Spring 定 义 的 
org.Springframework.web.servlet.Request ToView 
NameTranslator 接 口 的 getViewName 方 法 来 实现 的 ， 
我 们 可 以 实现 目 己 的 Request ToViewName 
Translator 接 口 来 约定 好 没有 返回 视 几 名 称 的 时 候 如 
何 确定 视图 名 称 。Spring 已 经 给 我 们 提供 了 一 个 它 
目 己 的 实现 ， 那 就 是 
org.Springframework.web.servlet.view.DefaultRequest 
ToViewName Translator. 























1E 4r £3 DefaultRequestToViewNameTranslatorzé 
AAA EAA APR ZA, FORA RESCH E 
义 的 属性 。 


e prefix: 前 绥 ， 表 示 约 定好 的 视 网 名 称 需要 加 上 

的 前 级 ， 默 认 是 空 

e suffix: 后 级 ， 表 示 约 定好 的 视图 名 称 需 要 加 上 
的 后 级 ， 默 认 是 空 

e separator: DRAF, BURIALS”. 

e stripLeadingSlash: 如 果 首 字符 是 分 隔 符 ， 是 人 否 
要 去 除 ， 默 认 是 true。 

e stripTrailingSlash: 如 果 最 后 一 个 字符 是 分 陋 























^j. MET XXE BRU Etrue. 

e stripExtension: 如 果 请 求 路 径 包 含 扩展 名 是 否 要 
去 除 ， 默 认 是 true。 

e urlDecode: 是 人 否 需 要 对 UREL 解 码 ， 默 认 是 true。 
它 会 采用 request 指 定 的 编码 或 者 ISO-8859-1 编 码 
对 URL 进 行 解码 。 


当 我 们 没有 在 SpringMVC 的 配置 文件 中 手动 的 
定义 一 个 名 为 viewNameTranlator 的 Bean 的 时 候 ， 
Spring 就 会 为 我 们 提供 一 个 默认 的 
viewNameTranslator, H||DefaultRequest 
ToViewName Translator. 


接 下 来 看 一 下 ， 当 Controller 处 理 器 方法 没有 返 
回 逻 辑 视 图 名 称 时 ，DefaultRequestToView 
NameTranslator 是 如 何 约 定 视 图 名 称 的 。 
DefaultRequestToViewNameTranslator 会 获取 到 请 求 
的 URI， 然 后 根据 提供 的 属性 做 一 些 改 造 ， 把 改造 
之 后 的 结果 作为 视图 名 称 返 回 。 这 里 以 请 求 路 径 
http://localhost/app/test/index.html 为 例 ， 来 说 明 一 下 
DefaultRequestToViewNameTranslator 是 如 何 工作 
的 。 该 请求 路 径 对 应 的 请 求 URI 为 /test/index.html， 
我 们 来 看 以 下 几 种 情况 ， 它 分 别 对 应 的 逻辑 视图 名 
BRIENTA -o 


。prefix 和 suffix 如 宁都 存在 ， 其 他 为 默认 值 ， 那 么 
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prefixtest/indexsuffix - 

e stripLeadingSlash 和 stripExtension 都 为 false， 其 
他 默认 ， 这 时 候 对 应 的 逻辑 视图 名 称 
是 /product/index.html。 

。 都 采用 默认 配置 时 ， 返 回 的 人 逻辑 视图 名 称 应 该 


是 product/index。 


如 果 远 辑 视 图 名 称 跟 请 求 路 径 相 同 或 者 相关 关 
系 部 是 一 样 的 ， 那 么 我 们 束 可 以 采用 Spring 为 我 们 
事先 约定 好 的 逻辑 视图 名 称 返 回 ， 这 可 以 大 大 简化 
我 们 的 开发 工作 ， 而 以 上 蕊 能 实现 的 关键 属性 
viewNameTranslator， 则 是 在 
initRequestToViewNameTranslator 中 完成 。 














private void initRequestToViewNameTranslator(ApplicationContext 
context) { 


try { 
this.viewNameTranslator = 
context.getBean(REQUEST TO VIEW NAME TRANS 





LATOR BEAN NAME, 
RequestToViewNameTranslator.class); 
if (logger.isDebugEnabled()) (1 
logger.debug("Using RequestToViewNameTranslato 
r [" * this.viewName 
Translator + "]|"); 


catch (NoSuchBeanDefinitionException ex) { 
// We need to use the default. 
this.viewNameTranslator - getDefaultStrategy(conte 
xt, RequestToViewName 
Translator.class); 
if (logger.isDebugEnabled()) { 


logger.debug("Unable to locate RequestToViewNa 


meTranslator with name '" + 
REQUEST TO VIEW NAME TRANSLATOR BEAN N 


AME + "': using default [" + this.viewNameTranslator + 





j 
i 





8. 初始 化 ViewResolvers。 


在 SpringMVC 中 ， 当 Controller 将 请 求 处 理 结 
放 入 到 ModelAndView 中 以 后 ，DispatcherServlet 会 
根据 ModelAndView 选 择 合适 的 视图 进行 泻 染 。 那 
么 在 SpringMVC 中 是 如 何 选 择 合适 的 View 呢 ? View 
对 象 是 是 如 何 创 建 的 呢 ?” 管 案 束 在 ViewResolver 
中 。ViewResolver 接 口 定 义 了 resolverViewName 方 
法 ， 根 据 viewName 创 建 合适 类 型 的 View 实 现 。 





那么 如 何 配置 ViewResolver 呢 ? 在 Spring 中 ， 
ViewResolver 作 为 Spring Bean 存 在 ， 可 以 在 Spring 
配置 文件 中 进行 配置 ， 例 如 下 面 的 代码 ， 配 置 了 
JSP 相 关 的 viewResolver。 


«bean class="org.Springframework.web.servlet.view. Internal 


ResourceViewResolver"> 
<property name="prefix" value="/WEB-INF/views/"/> 


«property name-z"suffix" value=".jsp"/> 
</bean> 





viewResolvers 属 性 的 初始 化 工作 在 


initViewResolvers 中 完成 。 








private void initViewResolvers(ApplicationContext context) ( 
this.viewResolvers - null; 


if (this.detectAllViewResolvers) { 
// Find all ViewResolvers in the ApplicationContex 
t, including ancestor 
contexts. 
Map<String, ViewResolver» matchingBeans = 
BeanFactoryUtils.beansOfTypelIncludingAnces 
tors(context, ViewResolver. class, true, false); 
if (!matchingBeans.isEmpty()) ( 
this.viewResolvers - new ArrayList«ViewResolve 
r>(matchingBeans. values()); 
// We keep ViewResolvers in sorted order. 
OrderComparator.sort(this.viewResolvers); 


} 
} 
else ( 
try { 
ViewResolver vr - context.getBean(VIEW RESOLVE 
R BEAN NAME, ViewResolver. class); 
this.viewResolvers = Collections.singletonList 
(vr); 
} 
catch (NoSuchBeanDefinitionException ex) { 
// Ignore, we'll add a default ViewResolver la 


ter. 
} 
} 
// Ensure we have at least one ViewResolver, by regist 
ering 
// a default ViewResolver if no other resolvers are fo 
und. 


if (this.viewResolvers -- null) ( 
this.viewResolvers - getDefaultStrategies(context, 
ViewResolver.class); 
if (logger.isDebugEnabled()) (1 
logger.debug("No ViewResolvers found in servle 
t '" + getServletName() + "': using default"); 


9. 初始 化 FlashMapManager。 


SpringMVC Flash attributes 提 供 了 一 个 请 求 存 
储 属 性 ， 可 供 其 他 请 求 使 用 。 在 使 用 重 定 癌 时 候 非 
常 必 要 ， 例 如 Post/Redirect/Get 模 式 。Flash attributes 
在 重 定 同 之 前 暂 存 ( 束 像 存在 session 中 〉 以 便 重 定 
癌 之 后 还 能 使 用 ， 并 立即 删除 。 


SpringMVC 有 两 个 主要 的 抽象 来 文 持 flash 
attributes。 FlashMap 用 于 保持 flash attributes ， 而 
FlashMapManager 用 于 存储 、 检 索 、 管 理 FlashMap 
实例 。 


flash attribute 支 持 默 认 开 启 ("on"〉 并 不 需要 
显 式 局 用 ， 它 永远 不 会 导致 HTTP Session 的 创建 。 
这 两 个 FlashMap 实 例 都 可 以 通过 静态 方法 
RequestContextUtils 从 Spring MVC 的 任何 位 置 访 
问 。 


flashMapManager 的 初始 化 在 
initFlashMapManager 中 完成 。 


private void initFlashMapManager(ApplicationContext context) { 
try { 














this.flashMapManager - 
context.getBean(FLASH MAP MANAGER BEAN NAM 
E, FlashMapManager.class); 
if (logger.isDebugEnabled()) (1 
logger.debug("Using FlashMapManager [" + this. 
flashMapManager + "]"); 


j 


catch (NoSuchBeanDefinitionException ex) { 
// We need to use the default. 
this.flashMapManager - getDefaultStrategy(context, 
FlashMapManager. class); 
if (logger.isDebugEnabled()) { 
logger.debug("Unable to locate FlashMapManager 
with name '" + 
FLASH MAP MANAGER BEAN NAME + "': usin 
g default [" + this. 
flashMapManager + "]"); 


j 





11.4 DispatcherServlet 的 逻辑 处 理 





根据 之 前 的 示例 ， 我 们 知道 在 HttpServlet 类 中 
分 别提 供 了 相应 的 服务 方法 ， 它 们 是 doDelete()、 
doGet()、doOptions()、doPost()、doPutO 和 
doTrace()， 它 会 根据 请 求 的 不 同形 式 将 程序 引导 到 
对 应 的 函数 进行 处 理 。 这 几 个 函数 中 最 利用 的 函数 
无 非 就 是 doGet0 和 doPost0， 那 么 我 们 就 直接 查看 
DispatcherServlet 中 对 于 这 两 个 函数 的 逻辑 实现 。 








QOverride 
protected final void doGet(HttpServletRequest request, HttpServ 


letResponse response) 
throws ServletException, IOException { 


processRequest 


(request, response); 


Jj 


@Override 
protected final void doPost(HttpServletRequest request, HttpSer 
vletResponse response) 

throws ServletException, IOException { 


processRequest 


(request, response); 


j 





对 于 不 同 的 方法 ， Spring 并 没有 做 特殊 处 理 ， 
而 古 统 一 将 程序 再 一 次 地 引导 全 process 
Request(request, response) 中 。 





protected final void processRequest(HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException { 




















// 记 录 当 前 时 间 ， 用 于 计算 web 请 求 的 处 理 时 间 
long StartTime = System.currentTimeMillis(); 
Throwable failureCause - null; 








// Expose current LocaleResolver and request as Locale 
Context. 

LocaleContext previousLocaleContext - LocaleContextHol 
der.getLocaleContext(); 

LocaleContextHolder.setLocaleContext(buildLocaleContex 
t(request), this.threadContextInheritable); 


// Expose current RequestAttributes to current thread. 
RequestAttributes previousRequestAttributes - RequestC 


ontextHolder. GetRequest Attributes(); 
ServletRequestAttributes requestAttributes - null; 
if (previousRequestAttributes -- null || previousReque 
stAttributes. getClass(). 
equals(ServletRequestAttributes.class)) { 
requestAttributes = new ServletRequestAttributes(r 
equest); 
RequestContextHolder.setRequestAttributes(requestA 
ttributes, this.thread 
ContextInheritable); 


} 
if (logger.isTraceEnabled()) { 
logger.trace("Bound request context to thread: " + 
request); 
} 
try { 
doService 


(request, response); 


catch (ServletException ex) { 
failureCause = ex; 
throw ex; 

} 

catch (IOException ex) { 
failureCause = ex; 
throw ex; 


catch (Throwable ex) { 
failureCause = ex; 
throw new NestedServletException("Request processi 
ng failed", ex); 


finally ( 
// Clear request attributes and reset thread-bound 
context. 
LocaleContextHolder.setLocaleContext(previousLocal 
eContext,this.threadContext Inheritable); 
if (requestAttributes !- null) ( 
RequestContextHolder.setRequestAttributes(prev 
iousRequestAttributes, this.threadContextInheritable); 
requestAttributes.requestCompleted(); 


if (logger.isTraceEnabled()) { 
logger.trace("Cleared thread-bound request con 
text: " + request); 


j 


if (logger.isDebugEnabled()) (1 
if (failureCause !- null) { 
this.logger.debug("Could not complete requ 
est", failureCause); 


else ( 
this.logger.debug("Successfully completed 
request"); 


j 


} 
if (this.publishEvents) { 
// Whether or not we succeeded, publish an eve 
nt. 
long processingTime - System.currentTimeMillis 
() - startTime; 
this.webApplicationContext.publishEvent( 
new ServletRequestHandledEvent(this, 
request.getRequestURI(), reque 
st.getRemoteAddr(), 
request.getMethod(), getServle 
tConfig().getServletName(), 
WebUtils.getSessionlId(request) 
, getUsernameForRequest(request), 
processingTime, failureCause)) 





函数 中 已 经 开始 了 对 请 求 的 处 理 ， 虽 然 把 细节 
转移 到 了 doService 函 数 中 实现 ， 但 是 我 们 不 难看 出 
处 理 请 求 前 后 所 做 的 准备 与 处 理工 作 。 


1. 为 了 保证 当前 线程 的 LocaleContext 以 及 
RequestAttributes 可 以 在 当前 请 求 后 还 能 恢复 ， 提 取 
当前 线程 的 两 个 属性 。 


2. 根据 当前 request 创 建 对 应 的 LocaleContext 
和 RequestAttributes， 并 绑 定 到 当前 线程 。 


3. 委托 给 doService 方 法 进一步 处 理 。 
4. 请 求 处 理 结束 后 恢复 线程 到 原始 状态 。 
5. 请 求 处 理 结 束 后 无 论 成 功 与 否 发 布 事件 通 





继续 查看 doService 方 法 。 





protected void doService(HttpServletRequest request, HttpServle 
tResponse response) 
throws Exception { 
if (logger.isDebugEnabled()) ( 
String requestUri - urlPathHelper.getRequestUri(re 


quest); 
logger.debug("DispatcherServlet with name '" + get 
ServletName() + "' 
processing " + request.getMethod() + 
" request for [" + requestUri + "]"); 


j 


// Keep a snapshot of the request attributes in case o 
f an include, 
// to be able to restore the original attributes after 
the include. 
Map<String, Object» attributesSnapshot = null; 
if (WebUtils.isIncludeRequest(request)) { 


logger.debug("Taking snapshot of request attribute 
S before include"); 
attributesSnapshot = new HashMap<String, Object>() 
了 
Enumeration<?> attrNames = request.getAttributeNam 
es(); 
while (attrNames.hasMoreElements()) { 
String attrName - (String) attrNames.nextEleme 
nt(); 
if (this.cleanupAfterInclude || attrName.start 
swith ("org.Springframework. web.servlet")) ( 
attributesSnapshot.put(attrName, request.g 
etAttribute (attrName)); 
} 
} 
} 


// Make framework objects available to handlers and vi 
ew objects. 

request.setAttribute(WEB APPLICATION CONTEXT ATTRIBUTE 
, getWebApplicationContext()); 

request.setAttribute(LOCALE RESOLVER ATTRIBUTE, this.l 
ocaleResolver); 

request.setAttribute(THEME RESOLVER ATTRIBUTE, this.th 
emeResolver); 

request.setAttribute(THEME SOURCE ATTRIBUTE, getThemeS 
ource( )); 


FlashMap inputFlashMap - this.flashMapManager.retrieve 
AndUpdate(request, response); 

if (inputFlashMap !- null) { 

request.setAttribute(INPUT FLASH MAP ATTRIBUTE, Co 

llections.unmodifiableMap (inputFlashMap)); 

} 

request.setAttribute(OUTPUT FLASH MAP ATTRIBUTE, new F 
lashMap()); 

request.setAttribute(FLASH MAP MANAGER ATTRIBUTE, this 
.flashMapManager); 


try { 
doDispatch(request, response); 
} 


finally { 
// Restore the original attribute snapshot, in cas 
e of an include. 


if (attributesSnapshot !- null) { 
restoreAttributesAfterInclude(request, attribu 
tesSnapshot); 


j 





我 们 猜想 对 请 求 处 理 至 少 应 该 包括 一 些 诸如 寻 
找 Handler 并 页 面 跳 转 之 类 的 逻辑 处 理 ， 但 是 ， 在 
doService 中 我 们 并 没有 看 到 想 看 到 的 逻辑 ， 相 反 却 
同样 是 一 些 准 备 工 作 ， 但 是 这 些 准 备 工作 却 是 必 不 





可 少 的 。Spring 将 已 经 初始 化 的 功能 辅助 工具 变 
量 ， 比 如 localeResolver、themeResolver 等 设置 在 
request 属 性 中 ， 而 这 些 属性 会 在 接 下 来 的 处 理 中 派 
EHH. 


经 过 层 层 的 准备 工作 ， 终 于 在 doDispatch 也 数 
中 看 到 了 完整 的 请 求 处 理 过程 。 








protected void doDispatch(HttpServletRequest request, HttpServl 

etResponse response) 

throws Exception ( 
HttpServletRequest processedRequest 
HandlerExecutionChain mappedHandler 
int interceptorIndex - -1; 


request; 
null; 


try { 
ModelAndView mv; 
boolean errorView - false; 


try { 
// 如 果 是 MultipartContent 类 型 的 request 则 转换 reduest 为 MuLtipartHttpSe 
rvletRequest##! request 
processedRequest = checkMultipart 


(request); 


// 根 据 request 信 息 寻 找 对 应 的 HandJer 
mappedHandler = getHandler 


(processedRequest, false); 
if (mappedHandler -- null || mappedHandler.get 
Handler() -- null) ( 
// 如 果 没 有 找到 对 应 的 handler 则 通过 response 反 馈 错 








误 信 息 
noHandlerFound 


(processedRequest, response); 
return; 
} 


// 根 据 当 前 的 handler 寻 找 对 应 的 HandlerAdapter 
HandlerAdapter ha = getHandlerAdapter 


(mappedHandler.getHandler()); 














// 如 果 当 前 handler 支 持 last-modified 尖 处 理 
String method = request.getMethod(); 
boolean isGet = "GET".equals(method); 
if (isGet || "HEAD".equals(method)) { 
long lastModified - ha.getLastModified(req 
uest, mappedHandler. 
getHandler()); 








if (logger.isDebugEnabled()) { 
String requestUri - urlPathHelper.getR 
equestUri(request); 
logger.debug("Last-Modified value for 
[" + requestUri + "] is: " + lastModified); 


if (new ServletWebRequest(request, respons 
e).checkNotModified 
(lastModified) && isGet) { 
return; 
} 


// 拦 截 器 的 preHand1ler 方 法 的 调用 

HandlerInterceptor[] interceptors = mappedHand 
ler.getInterceptors(); 

if (interceptors != null) { 





for (int i = 0; i « interceptors.length; i 

++) { 

HandlerInterceptor interceptor = inter 
ceptors[i]; 

if (!interceptor.preHandle(processedRe 
quest, response, 
mappedHandler.getHandler())) { 

triggerAfterCompletion 


(mappedHandler, interceptorIndex, 
processedRequest, response, null); 
return; 


j 


interceptorIndex - i; 


} 


// 真 正 的 激活 handler 并 返回 视图 
mv = ha.handle(processedRequest, response, map 
pedHandler.getHandler()); 














// 视 图 名 称 转换 应 用 于 需要 添加 前 绥 后 绥 的 情况 
if (mv != null && !mv.hasView()) { 
mv.setViewName(getDefaultViewName (request) 


); 








} 
// 应 用 所 有 拦截 器 的 postHandle 方 法 
if (interceptors != null) { 


for (int i = interceptors.length - 1; i >= 
0; i--) { 
HandlerInterceptor interceptor = inter 
ceptors[i]; 
interceptor.postHandle(processedReques 
t, response, mappedHandler. getHandler(), mv); 


j 


catch (ModelAndViewDefiningException ex) { 
logger.debug("ModelAndViewDefiningException en 
countered", ex); 
mv = ex.getModelAndView(); 
} 
catch (Exception ex) { 
Object handler = (mappedHandler !- null ? mapp 


edHandler.getHandler() : null); 
mv = processHandlerException 


(processedRequest, response, handler, ex); 
errorView - (mv !- null); 


j 


// Did the handler return a view to render? 
// 如 果 在 Handler 实 例 的 处 理 中 返回 了 view， 那 么 需要 做 页 面 的 处 






































if (mv != null && !mv.wasCleared()) { 
// 处 理 页 面 跳 转 
render 




















(mv, processedRequest, response); 
if (errorView) { 
WebUtils.clearErrorRequestAttributes(reque 
st); 
} 
} 


else { 
if (logger.isDebugEnabled()) { 
logger.debug("Null ModelAndView returned t 
o DispatcherServlet 
with name '" + getServletName() + 
"'i assuming HandlerAdapter comple 
ted request handling"); 
} 
} 




















// 完 成 处 理 激 活 触发 器 
triggerAfterCompletion 





(mappedHandler, interceptorIndex, processedRequest, response, n 
ull); 


j 


catch (Exception ex) { 
// Trigger after-completion for thrown exception. 
triggerAfterCompletion(mappedHandler, interceptorI 
ndex, processedRequest, response, ex); 
throw ex; 


catch (Error err) ( 


ServletException ex - new NestedServletException(" 
Handler processing 
failed", err); 

// Trigger after-completion for thrown exception. 

triggerAfterCompletion(mappedHandler, interceptorI 
ndex, processedRequest, response, ex); 


throw ex; 
} 
finally { 
// Clean up any resources used by a multipart requ 
est 
if (processedRequest !- request) ( 
cleanupMultipart(processedRequest); 
} 
} 
} 





doDispatch 函 数 中 展示 了 Spring 请 求 处 理 所 涉 及 
的 主要 人 逻辑 ， 而 我 们 之 前 设置 在 request 中 的 各 种 辅 
助 属 性 也 都 有 被 派 上 了 有 用场。 下 面 回顾 一 下 逻辑 处 
SH EAE 


11.4.1 MultipartContent2é #! request 
处 理 


对 于 请 求 的 处 理 ，Spring 首 先 考虑 的 是 对 于 
Multipart 的 处 理 ， 如 果 是 MultipartContent 类 型 的 
request， 则 转换 request 为 
MultipartHttpServletRequest 类 型 的 request。 





protected HttpServletRequest checkMultipart(HttpServletRequest 
request) throws MultipartException { 
if (this.multipartResolver !- null && this.multipartRe 
solver.isMultipart(request)) { 
if (request instanceof MultipartHttpServletRequest 


) i 
logger.debug("Request is already a MultipartHt 
tpServletRequest - if 


not in a forward, " + 
"this typically results from an additi 


onal MultipartFilter in web.xml"); 


} 
else { 
return this.multipartResolver.resolveMultipart 


(request); 


j 


// If not returned before: return original request. 
return request; 





11.4.2. ”根据 request 信 息 寻 找 对 应 的 
Handler 


在 Spring 中 最 简单 的 映射 处 理 器 配置 如 下 : 


«bean id-"simpleUrlMapping" 
class-z"org.Springframework.web.servlet.handler.SimpleU 
rlHandlerMapping"> 
<property name="mappings"> 
<props> 
<prop key="/userlist.htm">userController</prop 


</props> 
</property> 
</bean> 





在 Spring 加 载 的 过 程 中 ，Spring 会 将 类 型 为 
SimpleUrlHandlerMapping 的 实例 加 载 到 
this.handlerMappings 中 ， 按 照常 理 推断 ， 根 据 
request 提 取 对 应 的 Handler， 无 非 束 是 提取 当前 实例 
中 的 userController， 但 是 userController 为 继承 自 
AbstractController 类 型 实例 ， 与 Handler 
ExecutionChain 并 无 任何 关联 ， 那 么 这 一 步 是 如 何 
TX ? 








protected HandlerExecutionChain getHandler(HttpServletRequest r 
equest, boolean cache) throws Exception ( 
return getHandler 


(request); 


protected HandlerExecutionChain getHandler(HttpServletRequest r 
equest) throws Exception { 
for (HandlerMapping hm : this.handlerMappings) { 
if (logger.isTraceEnabled()) { 
logger .trace( 

"Testing handler map [" + hm + "] in D 
ispatcherServlet with 
name '" + getServletName() + "'"); 


HandlerExecutionChain handler = hm.getHandler 


(request); 
if (handler != null) { 
return handler; 
} 


} 


return null; 











在 之 前 的 内 容 我 们 提 过 ， 在 系统 局 动 时 Spring 
会 将 所 有 的 映射 类 型 的 bean 注 册 到 
this.handlerMappingsAE se rH, rU Jc eg ZH] HEISE 
是 远 历 上 所 有 的 HandlerMapping， 并 调用 其 getHandler 
方法 进行 封装 处 理 。 以 SimpleUrlHandlerMapping 为 
例 查 看 其 getHandler 方 法 如 下 : 


public final HandlerExecutionChain getHandler(HttpServletReques 
t request) throws Exception { 

// 根 据 request 获 取 对 应 的 handler 

Object handler = getHandlerInternal 


(request); 
if (handler == null) { 
// 如 果 没 有 对 应 request 的 handler 则 使 用 默认 的 handler 
handler = getDefaultHandler(); 



































} 
// 如 果 也 没有 提供 默认 的 handler 则 无 法 继续 处 理 返 回 null 
if (handler == null) { 
return null; 














j 


// Bean name or resolved handler? 
if (handler instanceof String) { 
String handlerName - (String) handler; 
handler = getApplicationContext().getBean(handlerN 


return getHandlerExecutionChain 


(handler, request); 


j 








函数 中 首先 会 使 用 getHandlerInternal 方 法 根据 
request 信 息 获 取 对 应 的 Handler， 如 果 以 
SimpleUrlHandlerMapping 为 例 分 析 ， 那 么 我 们 推断 








Jt Ese FEY BER n] BEC TRJSURL4X uU CES] 
Controller 并 人 返回， 当然 如 果 没 有 找到 对 应 的 
Controller 处 理 器 那么 程序 会 尝试 去 查找 配置 中 的 默 
认 处 理 器 ， 当 然 ， 当 得 找 的 controller 为 String 关 型 
时 ， 那 就 意味 着 返回 的 是 配置 的 bean 名 称 ， 需 要 根 
据 bean 名 称 查 找 对 应 的 bean， 最 后 ， 还 要 通过 
getHandlerExecutionChain 方 法 对 返回 的 Handler 进 行 
封闭， 以 保证 满足 返回 类 型 的 匹配 。 下 面 详 细 分 析 
Xx] fe 








1. RH request Æ $R X] HY) Handler 


首先 从 根据 request 和 查找 对 应 的 Handler 开 始 分 
Wr. 





protected Object getHandlerInternal(HttpServletRequest request) 


throws Exception { 
// 截 取 用 于 匹配 的 urLI 有 效 路 径 
String lookupPath = getUrlPathHelper().getLookupPathFo 
rRequest(request); 
// 根 据 路 径 寻 找 Handler 
Object handler = lookupHandler 

















(lookupPath, request); 
if (handler -- null) ( 
Object rawHandler - null; 
if ("/".equals(lookupPath)) ( 
// 如 果 请 求 的 路 径 仅 仅 是 "/"， 那 么 使 用 RootHandJer 进 行 处 




















rawHandler = getRootHandler(); 


if (rawHandler == null) { 
// 无 法 找到 handler 则 使 用 默认 handler 








rawHandler - getDefaultHandler(); 


if (rawHandler !- null) { 
// 根 据 beanName 获 取 对 应 的 bean 
if (rawHandler instanceof String) { 
String handlerName = (String) rawHandler; 
rawHandler = getApplicationContext().getBe 
an(handlerName) ; 





} 
// 模 版 方法 
validateHandler(rawHandler, request); 
handler = buildPathExposingHandler 


(rawHandler, lookupPath, lookupPath, null); 
} 


} 
if (handler != null && logger.isDebugEnabled()) { 
logger.debug("Mapping [" + lookupPath + "] to " + 
handler); 


} 
else if (handler == null && logger.isTraceEnabled()) { 
logger.trace("No handler mapping found for [" + lo 
okupPath + "]"); 


return handler; 


j 


protected Object lookupHandler(String urlPath, HttpServletReque 
st request) throws Exception { 
// 直 接 匹 配 情况 的 处 理 
Object handler = this.handlerMap.get(urlPath); 
if (handler != null) { 
// Bean name 
if (handler instanceof String) { 
String handlerName - (String) handler; 
handler - getApplicationContext().getBean(hand 



































lerName); 


validateHandler(handler, request); 
return buildPathExposingHandler(handler, urlPath, 
urlPath, null); 





























} 
// 通配符 匹配 的 处 理 
List«String» matchingPatterns = new ArrayList<String>( 








); 


for (String registeredPattern : this.handlerMap.keySet 
O) í 


ath)) { 


if (getPathMatcher().match(registeredPattern, urlP 


matchingPatterns.add(registeredPattern); 


j 


} 
String bestPatternMatch = null; 


Comparator«String» patternComparator - getPathMatcher( 
).getPatternComparator(urlPath); 
if (!matchingPatterns.isEmpty()) ( 
Collections.sort(matchingPatterns, patternComparat 
or); 
if (logger.isDebugEnabled()) (1 
logger.debug("Matching patterns for request [" 
+ urlPath + "] are " + matchingPatterns); 


} 
bestPatternMatch = matchingPatterns.get(0); 


} 
if (bestPatternMatch !- null) { 
handler = this.handlerMap.get(bestPatternMatch); 
// Bean name or resolved handler? 
if (handler instanceof String) { 
String handlerName - (String) handler; 
handler - getApplicationContext().getBean(hand 
lerName); 


validateHandler(handler, request); 

String pathwithinMapping - getPathMatcher().extrac 
tPathwithinPattern 
(bestPatternMatch, urlPath); 


// There might be multiple 'best patterns', let's 
make sure we have the 
correct URI template variables 
// for all of them 
Map<String, String> uriTemplateVariables = new Lin 
kedHashMap<String, String>(); 
for (String matchingPattern : matchingPatterns) { 
if (patternComparator.compare(bestPatternMatch 
, matchingPattern) == 0) { 
uriTemplateVariables 
.putAll(getPathMatcher().extractUr 
iTemplateVariables 
(matchingPattern, urlPath)); 


j 


if (logger.isDebugEnabled()) (1 


logger.debug("URI Template variables for reque 
st [" + urlPath + "] 


are " + uriTemplateVariables) ; 


} 
return buildPathExposingHandler 


(handler, bestPatternMatch, pathWithinMapping, uriTemplateVaria 
bles); 
} 


// No handler found... 
return null; 








根据 URL 获 取 对 应 Handler 的 匹配 规则 代码 实现 
起 来 虽然 很 长 ， 但 是 并 不 难 理解 ， 考 虑 了 直接 匹配 





与 通配符 两 种 情况 。 其 中 要 提 及 的 是 
buildPathExposingHandler 函 数 ， 它 将 Handler 封 装 成 
了 HandlerExecutionChain 类 型 。 





protected Object buildPathExposingHandler(Object rawHandler, St 
ring bestMatchingPattern, 

String pathWwithinMapping, Map<String, String» uriT 
emplateVariables) { 


HandlerExecutionChain chain - new HandlerExecutionChai 
n(rawHandler); 

chain.addInterceptor(new PathExposingHandlerIntercepto 
r(bestMatchingPattern, pathWithinMapping)); 

if (!CollectionUtils.isEmpty(uriTemplateVariables)) ( 


chain.addInterceptor(new UriTemplateVariablesHandl 
erInterceptor 


(uri TemplateVariables)); 


return chain; 


MEM 


在 函数 中 我 们 看 到 了 通过 将 Handler 以 参数 形式 
传 入 ， 并 构建 HandlerExecutionChain 类 型 实例 ， 加 
入 了 两 个 拦截 器 。 此 时 我 们 似乎 已 经 了 解 了 Spring 
这 样 大 番 周 打 的 目的 。 链 处 理 机 制 ， 是 Spring 中 非 
党 第 用 的 处 理 方 式 ， 是 AOP 中 的 重要 组 成 部 分 ， 可 
以 方便 地 对 目标 对 象 进行 扩 展 及 拦截 ， 这 是 非常 优 
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2. JANTES ETATE 


getHandlerExecutionChain 函 数 最 主要 的 目的 是 
将 配置 中 的 对 应 拦截 器 加 入 到 执行 链 中 ， 以 保证 这 
些 拦 规 器 可 以 有 效 地 作用 于 目标 对 象 。 








protected HandlerExecutionChain getHandlerExecutionChain(Object 
handler, HttpServletRequest 
request) { 
HandlerExecutionChain chain = 
(handler instanceof HandlerExecutionChain) ? 
(HandlerExecutionChain) handler : new HandlerE 
xecutionChain(handler); 


chain.addInterceptors(getAdaptedInterceptors()); 


String lookupPath - urlPathHelper.getLookupPathForRequ 
est(request); 
for (MappedInterceptor mappedInterceptor : mappedInter 
ceptors) ( 
if (mappediInterceptor.matches(lookupPath, pathMatc 


chain.addInterceptor(mappedInterceptor.getInte 


rceptor()); 


j 


return chain; 





11.43 ” 没 找 到 对 应 的 Handler 的 错误 处 理 





每 个 请 求 都 应 该 对 应 着 一 Handler， 因 为 每 个 请 
求 都 会 在 后 人 台 有 相应 的 逻辑 对 应 ， 而 逻辑 的 实现 就 
是 在 Handler 中 ， 所 以 一 旦 过 到 没有 找到 Handler 的 
情况 《〈 正 第 情况 下 如 采 没 有 UREL 匹 配 的 Handler， 开 
发 人 员 可 以 设置 默认 的 Handler 来 处 理 请 求 ， 但 是 如 
果 默 认 请 求 也 未 设置 就 会 出 现 Handler 为 空 的 情 
DU) ， 就 只 能 通过 response 回 用 户 返回 错误 信息 。 








protected void noHandlerFound(HttpServletRequest request, HttpS 
ervletResponse response) 
throws Exception { 
if (pageNotFoundLogger.isWarnEnabled()) { 
String requestUri - urlPathHelper.getRequestUri(re 
quest); 
pageNotFoundLogger.warn("No mapping found for HTTP 
request with URI [" + requestUri + 
"] in DispatcherServlet with name '" + get 
ServletName() + "'"); 


response.sendError(HttpServletResponse.SC NOT FOUND); 





11.4.4 根据 当前 Handler 寻 找 对 应 的 
HandlerAdapter 


在 WebApplicationContext 的 初始 化 过 程 中 我 们 
讨论 了 HandlerAdapters 的 初始 化 ， 了 解 了 在 默认 情 
况 下 普通 的 Web 请 求 会 区 给 
SimpleControllerHandlerAdapter 去 处 理 。 下 面 我 们 
以 SimpleControllerHandlerAdapter 为 例 来 分 析 获 取 
xÉ AC as HNZ E o 


protected HandlerAdapter getHandlerAdapter(Object handler) thro 
ws ServletException { 
for (HandlerAdapter ha : this.handlerAdapters) { 
if (logger.isTraceEnabled()) { 
logger.trace("Testing handler adapter [" + ha 


} 
if (ha.supports(handler)) { 
return ha; 


throw new ServletException("No adapter for handler [" 
+ handler + 


"]: Does your handler implement a supported in 
terface like Controller?"); 


j 
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SimpleControllerHandlerAdapterH? HJsupports 7; 1X; © 


public boolean supports(Object handler) { 
return (handler instanceof Controller); 


} 


分 析 到 这 里 ， 一 切 已 经 明了 ， 
SimpleControllerHandlerAdapter 就 是 用 于 人 处理 普通 
把 逻辑 封装 至 Controller 的 子 类 中 ， 例 如 我 们 之 前 的 
引导 示例 UserController 就 是 继承 自 
AbstractController, ifj AbstractControllerS lj 
Controller# L1, 


11.4.5 ”缓存 处 理 


在 研究 Spring 对 绥 存 处 理 的 功能 文 持 前 ， 我 们 
先 了 解 一 个 概念 : Last-Modified22 F WLI . 


1. 在 客户 端 第 一 次 输入 URL 时 ， 服 务 器 端 会 
返回 内 容 和 状态 码 200， 表 示 请 求 成 功 ， 同 时 会 添 
加 一 个 “Last-Modified” 的 啊 应 头 ， 表 示 此 文件 在 服 
务 器 上 的 最 后 更 新 时 间 ， 例 如 ，“Last- 
Modified:Wed, 14 Mar 2012 10:22:42 GMT” 表 示 最 后 
更 新 时 间 为 (2012-03-14 10:22) 。 








2. 客户 端 第 二 次 请 求 此 URL 时 ， 客 户 端 会 同 
服务 器 发 送 请求 头 “If-Modified-Since”， 询 问 服务 器 
该 时 间 之 后 当前 请 求 内 容 是 否 有 人 被 修改 过 ， 如 “If- 
Modified-Since: Wed, 14 Mar 2012 10:22:42 GMT”, 
A RC AS ai tim HIP EUH Ae. WU E 39 HTTP 
304353 CA BMS, AAA, PETA 
了 网 络 带宽 ) 。 


Spring 提供 的 对 Last-Modified 机 制 的 支持 ， 只 
需要 实现 LastModified 接 口 ， 如 下 所 示 : 





public class HelloWworldLastModifiedCacheController extends Abst 
ractController implements LastModified { 
private long lastModified; 
protected ModelAndView handleRequestInternal(HttpServletReq 
uest req, Http 
ServletResponse resp) throws Exception { 
// 点 击 后 再 次 请 求 当 前 页 面 
resp.getwriter().write("this"); 
return null; 











public long getLastModified(HttpServletRequest request) ( 
if(lastModified == OL) { 
// 第 一 次 或 者 逻辑 有 变化 的 时 候 ， 应 该 重新 返回 内 容 最 新 修改 的 时 间 




















lastModified = System.currentTimeMillis(); 


j 


return lastModified; 





HelloWorldLastModifiedCacheController Hz 22 
实现 LastModified 接 口 的 getLastModified 方 法 ， 保 证 


当 内 容 发生 改变 时 返回 最 新 的 修改 时 间 即 可 。 


Spring 判断 是 否 过 期 ， 通 过 判断 请 求 的 “If- 
Modified-Since” 是 否 大 于 等 于 当前 的 getLast 
Modified 方 法 的 时 间 惟 ， 如 果 是 ， 则 认为 没有 修 
改 。 上 和 耐 的 controller 与 普通 的 controller 并 无 太 大 到 
All, HU P: 








<bean name="/helloLastModified" class="com.test.controller.Hell 
oworldLastModifiedCache Controller"/» 





11.4.6 ”HandlerInterceptor 的 处 理 


Servlet API 定 义 的 servlet 过 滤器 可 以 在 servlet 处 
理 每 个 Web 请 求 的 前 后 分 别 对 它 进 行 前 置 处 理 和 后 
置 处 理 。 此 外 ， 有 些 时 候 ， 你 可 能 只 想 处 理由 某 些 
SpringMVC 处 理 程序 处 理 的 Web 请 求 ， 并 在 这 些 处 
理 程 序 返 回 的 模型 属性 被 传递 到 视图 之 前 ， 对 它们 
进行 一 些 操作 。 


SpringMVC 人 允许 你 通过 处 理 拦截 Web 请 求 ， 
进行 前 置 处 理 和 后 置 处 理 。 处 理 拦截 是 在 Spring 的 
Web 应 用 程序 上 下 文中 配置 的 ， 因 此 它们 可 以 利用 
各 种 容器 特性 ， 并 引用 容器 中 声明 的 任何 bean。 处 
理 拦 截 是 针对 特殊 的 处 理 程 序 映 射 进行 注册 的 ， 








它 只 拦截 通过 这 些 处 理 程 序 映射 的 请 求 。 每 个 处 
mpg 必须 实现 HandlerInterceptor 接 口 ， 它 包含 

三 个 需要 你 实现 的 回调 方法 : preHandleQ. 
postHlandle 和 afterCompletion()。 第 一 个 和 第 二 个 

分 别 是 在 处 理 程序 处 理 请 求 之 前 和 之 后 被 调用 

iti. 第 二 个 方法 还 允许 访问 返回 的 ModelAndView 
us. 因此 可 以 在 它 里 面 操作 模型 属性 。 最 后 一 个 
方法 古 在 所 有 请 求 处 理 完成 之 后 说 调用 的 (如 视图 
呈现 之 后 ) ， 以 下 是 HandlerInterceptor 的 简单 实 
现 : 











public class MyTestInterceptor implements HandlerInterceptor{ 
public boolean preHandle(HttpServletRequest request, 
HttpServletResponse response,Object handler)throws Exc 
eption{{ 
long startTime = System.currentTimeMillis(); 
request.setAttribute("startTime",startTime); 
return true; 


public void postHandle(HttpServletRequest request,HttpServ 
letResponse response, 
Object handler,ModelAndView modelAndView)throws Except 
ion{ 
long startTime = (Long)request.getAttribute("startTime 


request.removeAttribute("startTime"); 
long endTime - System.currentTimeMillis(); 
modelAndView.addObject("handlingTime",endTime-startTim 


} 
public void afterCompletion(HttpServletRequest request, 
HttpServletResponse response,Object handler,Exception 
ex)throws Exception( 


2 





在 这 个 拦截 器 的 preHandler() 方 法 中 ， 你 记录 了 
起 始 时 间 ， 并 将 它 保 存 到 请 求 属 性 中 。 这 个 方法 应 
该 返回 true， 人 允许 DispatcherServlet 继 续 处 理 请 求 。 
侍 则 ，DispatcherServlet 会 认为 这 个 方法 已 经 处 理 了 
请 求 ， 直 接 将 啊 应 返回 给 用 户 。 然 后 ， 在 
postHandler() 方 法 中 ， 从 请 求 属性 中 加 载 起 始 时 
则 ， 并 将 它 与 当前 时 间 进 行 比 较 。 你 可 以 计算 总 的 
持续 时 间 ， 然 后 把 这 个 时 间 添 加 到 模型 中 ， 传 递 给 
视图 。 最 后 ，afterCompletion() 方 法 无 事 可 做 ， 空 着 
MALT. 








11.4.7 ZAH 


X] T: RC ABE: SC ROB 1D ss rp EE id HH 
Handler 并 返回 视图 的 ， 对 应 代码 如 下 : 


mv = ha.handle(processedRequest, response, mappedHandler.getHan 
dler()); 


同样 ， 还 是 以 引导 示例 为 基础 进行 处 理 逻 辑 分 
析 ， 之 前 分 析 过 ， 对 于 普通 的 Web 请 求 ，Spring 默 
认 使 用 SimpleControllerHandlerAdapter 类 进行 处 
理 ， 我 们 进入 SimpleControllerHandlerAdapter 类 的 
handle 方 法 如 下 : 








public ModelAndView handle(HttpServletRequest request, HttpServ 
letResponse response, 
Object handler) 

throws Exception ( 


return ((Controller) handler).handleRequest(request, r 
esponse); 











但 是 回顾 引导 示例 中 的 UserController， 我 们 的 
逻辑 是 写 在 handleRequestInternal 函 数 中 而 不 是 
handleRequest 函 数 ， 所 以 我 们 还 需要 进一步 分 析 这 
期 间 所 包含 的 处 理 流 程 。 





public ModelAndView handleRequest(HttpServletRequest request, H 
ttpServletResponse response) 
throws Exception ( 


// Delegate to WebContentGenerator for checking and pr 
eparing. 

checkAndPrepare(request, response, this instanceof Las 
tModified); 





// 如 果 需 要 session 内 的 同步 执行 
if (this.synchronizeOnSession) ( 
HttpSession session - request.getSession(false); 
if (session !- null) ( 
Object mutex - WebUtils.getSessionMutex(sessio 
n); 
synchronized (mutex) { 
// 调 用 用 户 的 逻辑 


return handleRequestInternal(request, resp 














onse); 


} 
} 
// BAE 


return handleRequestInternal 














(request, response); 


j 


11.4.8 ”异常 视图 的 处 理 


有 时 候 系统 运行 过 程 中 出 现 异 音 ， 而 我 们 并 不 
硕 望 焉 此 中 断 对 用 户 的 服务 ， 而 是 至 少 告知 客户 当 
有 系统 在 处 理 示 辑 的 过 程 中 出 现 了 有 异 单 ， 甚 至 告知 
他 们 因为 什么 原因 导致 的 。Spring 中 的 异常 处 理 机 
制 会 帮 我 们 完成 这 个 工作 。 其 实 ， 这 里 Spring 主要 
的 工作 束 是 将 逻辑 引导 至 HandlerExceptionResolver 
类 的 resolveException 方 法 ， 而 
HandlerExceptionResolver 的 使 用 ， 我 们 在 讲解 
WebApplicationContext 的 初始 化 的 时 候 已 经 介绍 过 


o 























protected ModelAndView processHandlerException(HttpServletReque 
st request, HttpServletResponse response, 
Object handler, Exception ex) throws Exception ( 


// Check registered HandlerExceptionResolvers... 
ModelAndView exMv - null; 
for (HandlerExceptionResolver handlerExceptionResolver 
: this.handlerException 
Resolvers) ( 
exMv - handlerExceptionResolver.resolveException 


(request, response, handler, ex); 
if (exMv !- null) ( 
break; 


j 


if (exMv != null) { 
if (exMv.isEmpty()) ( 
return null; 


} 
// We might still need view name translation for a 


plain error model... 
if (!exMv.hasView()) { 
exMv.setViewName(getDefaultViewName(request)); 


} 
if (logger.isDebugEnabled()) { 
logger.debug("Handler execution resulted in ex 


ception - forwarding to resolved error view: " + exMv, ex); 


WebUtils.exposeErrorRequestAttributes(request, ex, 


getServletName()); 
return exMv; 
j 


throw ex; 





11.4.9 ”根据 视图 跳 转 页 面 


无 论 是 一 个 系统 还 是 一 个 站 后 ， 最 午 要 的 工作 
祁 是 与 用 户 进行 交互 ， 用 户 操 作 系 统 后 无 论 下 发 的 
命令 成 功 与 否 者 需要 给 用 户 一 个 反 饿 ， 以 便于 用 户 
进行 下 一 步 的 判断 。 所 以 ， 在 逻辑 处 理 的 最 后 一 定 
会 涉及 一 个 页 面 跳 转 的 问题 。 











protected void render(ModelAndView mv, HttpServletRequest reque 


st, HttpServletResponse response) throws Exception { 
// Determine locale for request and apply it to the re 


sponse. 
Locale locale = this.localeResolver.resolveLocale(requ 


est); 
response.setLocale(locale); 


View view; 

if (mv.isReference()) ( 
// We need to resolve the view name. 
view = resolveViewName 


(mv.getViewName(), mv.getModelInternal(), locale, request); 
if (view == null) { 
throw new ServletException( 


"Could not resolve view with name '" + 
mv.getViewName() + "' in servlet with name '" + 
getServletName() + "'"); 
} 
else { 


// No need to lookup: the ModelAndView object cont 
ains the actual View object. 
view = mv.getView(); 
if (view == null) { 
throw new ServletException("ModelAndView [" + 
mv + "] neither contains 
a view name nor a " + 
"View object in servlet with name '" + 
getServletName() + "'"); 


J 


// Delegate to the View object for rendering. 
if (logger.isDebugEnabled()) { 
logger .debug("Rendering view [" + view + "] in Dis 
patcherServlet with name 
'" + getServletName() + "'"); 


view. render 


(mv.getModelInternal(), request, response); 


j 





1. 解析 视图 名 称 





在 上 文中 我 们 提 到 DispatcherServlet 会 根据 
ModelAndView 选 择 合适 的 视图 来 进行 演 染 ， 而 这 
一 功能 就 是 在 resolveViewName 也 数 中 完成 的 。 





protected View resolveViewName(String viewName, Map<String, Obj 
ect» model, Locale locale, 
HttpServletRequest request) throws Exception { 


for (ViewResolver viewResolver : this.viewResolvers) ( 
View view - viewResolver.resolveViewName 


(viewName, locale); 
if (view !- null) { 
return view; 
} 
} 


return null; 





我 们 以 
org.Springframework.web.servlet.view.InternalResourc 
为 例 来 分 析 ViewResolver 逻 辑 的 解析 过 程 ， 其 中 
resolve ViewName A Zit HF] SE EW Xe 4E Hz 42 25 
AbstractCaching ViewResolver 中 完成 的 。 








public View resolveViewName(String viewName, Locale locale) thr 
Ows Exception ( 
if (!isCache()) (1 
// 不 存在 缓存 的 情况 下 直接 创建 视图 


return createView 











(viewName, locale); 


J 


else { 


// 直 接 从 缓存 中 提取 


Object cacheKey - getCacheKey(viewName, locale); 
synchronized (this.viewCache) { 
View view - this.viewCache.get(cacheKey); 
if (view -- null && (!this.cacheUnresolved || 
!this.viewCache. 
containsKey(cacheKey))) { 
// Ask the subclass to create the View obj 
ect. 
view - createView(viewName, locale); 
if (view !- null || this.cacheUnresolved) 


this.viewCache.put(cacheKey, view); 
if (logger.isTraceEnabled()) { 
logger.trace("Cached view [" + cac 


heKey + "]"); 


j 
j 


return view; 





在 父 类 UrlBasedViewResolver 中 重 写 了 
create View FAI 4X . 





protected View createView(String viewName, Locale locale) throw 
s Exception { 
// 如 果 当 前 解析 器 不 支持 当前 解析 器 如 ViewName 为 空 等 情况 
if (!canHandle(viewName, locale)) { 
return null; 











j 


// 处 理 前 缀 为 redirect :xx 的 情况 
if (viewName.startsWith(REDIRECT URL PREFIX)) { 
String redirectUrl - viewName.substring(REDIRECT U 
RL PREFIX.length()); 
RedirectView view - new RedirectView(redirectUrl, 
isRedirectContext 
Relative(), isRedirectHttpiOCompatible()); 























return applyLifecycleMethods(viewName, view); 


j 


// 处 理 前 缀 为 forward: xx 的 情况 
if (viewName.startsWith(FORWARD URL PREFIX)) { 
String forwardUrl - viewName.substring(FORWARD URL 
. PREFIX.length()); 
return new InternalResourceView(forwardUrl); 




















j 


// Else fall back to superclass implementation: callin 
g loadView. 
return super.createView 


(viewName, locale); 


j 


protected View createView(String viewName, Locale locale) throw 
s Exception { 
return loadView 


(viewName, locale); 


j 


protected View loadView(String viewName, Locale locale) throws 
Exception ( 
AbstractUrlBasedView view - buildView 


(viewName ) ; 
View result = applyLifecycleMethods(viewName, view); 
return (view.checkResource(locale) ? result : null); 


j 


protected AbstractUrlBasedView buildView(String viewName) throw 
S Exception ( 
AbstractUrlBasedView view - (AbstractUrlBasedView) Bea 
nUtils.instantiateClass (getViewClass()); 
// 添 加 前 级 以 及 后 级 
view.setUrl(getPrefix() + viewName + getSuffix()); 
String contentType - getContentType(); 
if (contentType !- null) ( 
// ContentType 
view.setContentType(contentType); 
} 
view.setRequestContextAttribute(getRequestContextAttri 
bute()); 


view.setAttributesMap(getAttributesMap()); 
if (this.exposePathVariables !- null) ( 
view.setExposePathVariables(exposePathVariables); 


return view; 





通读 以 上 代码 ， 我 们 发 现 对 于 
InternalResourceViewResolver 所 提供 的 解析 功能 主 
要 考虑 到 了 几 个 方面 的 处 理 。 


。 基 于 效率 的 考虑 ， 提 供 了 缓存 的 支持 。 

。 提 供 了 对 redirect:xx 和 forward:xx 前 级 的 支持 。 

。 添 加 了 前 缀 及 后 级 ， 并 向 View 中 加 入 了 必需 的 
属性 设置 。 





2. 页 面 跳 转 


当 通 过 viewName 解 析 到 对 应 的 View 后 ， 束 可 
以 进一步 地 处 理 跳 转 逻辑 了 。 





public void render(Map<String, ?> model, HttpServletRequest req 
uest, HttpServletResponse response) throws Exception ( 
if (logger.isTraceEnabled()) { 
logger.trace("Rendering view with name '" + this.b 
eanName + "' with model " + model + 
" and static attributes " + this.staticAttribu 


tes); 


j 


Map<String, Object» mergedModel = createMergedOutputMo 


(model, request, 

response); 
prepareResponse(request, response); 
renderMergedOutputModel 


(mergedModel, request, response); 


J 





在 引导 示例 中 ， 我 们 了 解 到 对 于 ModelView 的 





使 用 ， 可 以 将 一 些 属性 直接 放 入 其 中 ， 然 后 在 页 面 
上 直接 通过 JSTL 语 法 或 者 原始 的 request 获 取 。 这 是 
一 个 很 方便 也 很 神奇 的 功能 ， 但 是 实现 却 并 不 复 
杂 ， 无 非 是 把 我 们 将 要 用 到 的 属性 放 入 redquest 中 ， 
以 便 在 其 他 地 方 可 以 直接 调用 ， 而 解析 这 些 属 性 的 
Le ize tEcreateMergedOutputModel rf Zjt FH FE py, 

I 








protected Map<String, Object» createMergedOutputModel(Map<Strin 
g, ?» model, HttpServletRequest 
request, 


HttpServletResponse response) { 
@SuppressWarnings("unchecked" ) 
Map<String, Object> pathVars = this.exposePathVariable 
s? 


(Map<String, Object») request.getAttribute(View.PA 
TH VARIABLES) : null; 


// Consolidate static and dynamic model attributes. 

int size - this.staticAttributes.size(); 

size += (model !- null) ? model.size() : 0; 

size += (pathVars !- null) ? pathVars.size() : 0; 

Map<String, Object» mergedModel = new HashMap<String, 
Object>(size); 

mergedModel.putAll(this.staticAttributes); 


if (pathVars !- null) ( 
mergedModel.putAll(pathVars); 


} 

if (model != null) { 
mergedModel.putAll(model); 

} 


// Expose RequestContext? 
if (this.requestContextAttribute != null) { 
mergedModel.put(this.requestContextAttribute, crea 
teRequestContext(request, response, mergedModel) ); 


j 


return mergedModel; 


} 


// 处 理 页 面 跳 转 
protected void renderMergedOutputModel ( 
Map<String, Object> model, HttpServletRequest requ 
est, HttpServletResponse 
response) throws Exception { 




















// Determine which request handle to expose to the Req 
uestDispatcher. 

HttpServletRequest requestToExpose = getRequestToExpos 
e(request); 





// 将 model 中 的 数据 以 属性 的 方式 设置 到 request 中 


exposeModelAsRequestAttributes(model, requestToExpose) 


// Expose helpers as request attributes, if any. 
exposeHelpers(requestToExpose); 


// Determine the path for the request dispatcher. 
String dispatcherPath = prepareForRendering(requestToE 
xpose, response); 


// Obtain a RequestDispatcher for the target resource 
(typically a JSP). 
RequestDispatcher rd = getRequestDispatcher(requestToE 
xpose, dispatcherPath); 
if (rd -- null) ( 
throw new ServletException("Could not get RequestD 


ispatcher for [" + getUrl() + 

"]: Check that the corresponding file exis 
ts within your web 
application archive!"); 


// If already included or response already committed, 
perform include, else forward. 
if (uselnclude(requestToExpose, response)) { 
response.setContentType(getContentType()); 
if (logger.isDebugEnabled()) { 
logger .debug("Including resource [" + getUrl() 
+ "] in Internal 
ResourceView '" + getBeanName() + "'"); 


rd.include(requestToExpose, response); 


j 


else ( 

// Note: The forwarded resource is supposed to det 
ermine the content type itself. 

exposeForwardRequestAttributes(requestToExpose); 

if (logger.isDebugEnabled()) (1 

logger.debug("Forwarding to resource [" + getU 

rl() + "] in 
InternalResourceView '" + getBeanName() + "'"); 


rd.forward(requestToExpose, response); 





第 12 章 ”远程 服务 


Java 远 程 方法 调用 ， 即 JavaRMI (Java Remote 
Method Invocation) ， 是 Java 编 程 语言 里 一 种 用 于 
实现 远程 过 程 调 用 的 应 用 程序 编程 接口 。 它 使 客户 
机 上 运行 的 程序 可 以 调用 远程 服务 器 上 的 对 象 。 远 
程 方法 调用 特性 使 Java 编 程 人 员 能 够 在 网 络 环境 中 
分 布 操作 。RMI 全 部 的 守则 就 是 尽 可 能 地 简化 远程 
接口 对 象 的 使 用 。 


Java RMI 极 大 地 依赖 于 接口 。 在 需要 创建 一 个 
远程 对 象 时 ， 程 序 员 通过 传递 一 个 接口 来 隐藏 抵 层 
的 实现 细节 。 客 户 端 得 到 的 远程 对 象 句柄 正好 与 本 
地 的 根 代 码 连 接 ， 由 后 者 负责 透 过 网 络 通 信 。 这 样 
程序 员 只 需 关 心 如 何 通 过 上 自己 的 接口 句柄 发 
X B. 























12.1 RMI 


在 Spring 中 ， 同 样 提 供 了 对 RMI 的 文 持 ， 使 得 
在 Spring 下 的 RMI 开 发 变 得 更 方便 ， 同 样 ， 我 们 还 
是 通过 示例 来 快速 体验 RMI 所 提供 的 功能 。 





12.1.1 使 用 示例 


以 下 提供 了 Spring 整合 RMI 的 使 用 示例 。 


1. 建立 RMI 对 外 接口 。 


public interface HelloRMIService { 
public int getAdd(int a, int b); 


j 





2. 建立 接口 实现 类 。 


public class HelloRMIServicelImpl implements HelloRMIService { 


public int getAdd(int a, int b) { 
return a + b; 


Í 





3. 建立 服务 端 配置 文件 。 





«?xml version="1.0" encoding="UTF-8"?> 
«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 

xsi:schemaLocation-z" 
http://www.Springframework.org/schema/beans 
http://www.Springframework.org/schema/beans/Spring-beans-3.0.xs 
d Ws 
<! - -服务 端 - -> 

«bean id-"helloRMIServicelmpl" class="test.remote.HelloRMI 
ServiceImpl" /» 

«1-- 将 类 为 一 个 RMI 服 务 --> 

«bean id="myRMI" class-"org.Springframework.remoting.RMI.R 


MIServiceExporter"> 


<!-- 服务 类 --> 
«property name="Service" ref-'"helloRMIServiceImpl" /> 
<!-- 服务 名 --> 


<property name="ServiceName" value="helloRMI" /> 

<!-- 服务 接口 --> 

«property name="ServiceInterface" value="test.remote.H 
elloRMIService" /> 

<!-- 服务 端口 --> 

«property name="registryPort" value="9999" /> 

<!-- 其 他 属性 自己 查看 org.Springframework.remoting .RMI.RMI 











ServiceExporter 的 类 , 就 知道 文 持 的 属性 了 - -> 
«/bean» 
«/beans» 








4. SENT ARS mW. 


public class ServerTest ( 


public static void main(String[] args) { 
new ClassPathXmlApplicationContext("test/remote/RMISe 
rver.xml"); 


j 


j 








到 这 里 ， 建 立 RMI 服 务 端的 步骤 已 经 结束 了 ， 
服务 端 发 布 了 一 个 两 数 相 加 的 对 外 接口 供 其 他 服务 
侣 调用。 局 动 服 务 端 测试 类 ， 其 他 机 器 或 端口 便 可 
以 通过 RMI 来 连接 到 本 机 了 。 


5. 完成 了 服务 端的 配置 后 ， 还 需要 在 测试 站 
建立 测试 环 卉 以 及 测试 代码 。 首 先 建立 测试 并 配 置 
DO 





<?xml version="1.0" encoding="UTF-8"?> 
«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation-z" 

http://www.Springframework.org/schema/beans 
http://www.Springframework.org/schema/beans/Spring-beans-3.0.xs 
d Ws 

<1- -客户 端 - -> 

«bean id="myClient" class="org.Springframework.remoting.RMI 
.RMIProxyFactoryBean"> 


«property name="ServiceUrl" value="RMI://127.0.0.1:9999 
/helloRMI"/> 


«property name="ServiceInterface" value="test.remote.He 
1loRMIService"/> 
</bean> 
</beans> 





6. 编写 测试 代码 。 


public class ClientTest { 


public static void main(String[] args) { 
ApplicationContext context - new ClassPathXmlApplicati 
onContext ("test/remote/ RMIClient.xml"); 
HelloRMIService hms - context.getBean("myClient", Hell 


oRMIService.class); 
System.out.println(hms.getAdd(1, 2)); 


j 





DA ERER, SKI uim) ARS UR H e 
你 会 看 到 测试 端 通过 RMI 进 行 了 远程 连接 ， 连 接 到 
了 服务 痢 ， 并 使 用 对 应 的 实现 类 
HelloRMIServiceImpl 中 提供 的 方法 getAdd 来 计算 参 
数 并 返回 结 有 末 ， 你 会 看 到 控制 合 和 输出 了 3。 当 然 以 








E RS EF PEE H H — E 9 Li As Fed EE 2 I DEC 
不 同 机 右 的 RMI 连 接 。 在 企业 应 用 中 一 般 部 十 使 用 
不 同 的 机 右 来 进行 RMI 服 务 的 友 布 与 访问 ， 你 需要 
将 接口 打包 ， 并 放置 在 服务 端的 工程 中 。 


这 是 一 个 徐 单 的 方法 展示 ， 但 是 却 很 好 地 展示 
了 Spring 中 使 用 RMI 的 流程 以 及 步骤 ， 如 果 抛 弃 
Spring 而 使 用 原始 的 RMI 发 布 与 连接 ， 则 会 是 一 件 
很 及 烦 的 事情 ， 有 兴趣 的 读者 可 以 碍 阅 相 关 的 资 
料 。 在 Spring 中 使 用 RMI 非 党 简单 ，Spring 帮 助 我 们 
做 了 大 量 的 工作 ， 这 些 工 作 都 包括 什么 昵 ? 接 下 来 
我 们 一 起 深入 分 析 Spring 中 对 RMI 功 能 的 实现 原 
JH. 














12.1.2 ”服务 端 实现 





首先 我 们 从 服务 中 的 发布 功能 开始 痢 手 ， 同 
样 ，Spring 中 的 核心 还 是 配置 文件 ， 这 是 所 有 功能 
的 基础 。 在 服务 问 的 配置 文件 中 我 们 可 以 看 到 ， 定 
义 了 两 个 bean， 其 中 一 个 是 对 接口 实现 类 的 发 布 ， 
而 另 一 个 则 是 对 RMI 服 务 的 发 布 ， 使 用 
org.Springframework.remoting. RMI.RMIServiceExpor 
类 进行 封装 ， 其 中 包括 了 服务 类 、 服 务 名 、 服 务 接 
趾 、 服 务 尊 口 等 大 干 属性 ， 因 此 我 们 可 以 断定 ， 
org.Springframework.remoting.RMI.RMIServiceExpor 

















类 应 该 是 发 布 RMI 的 关键 类 。 我 们 可 以 从 此 类 入 手 
进行 分 析 。 


根据 前 面 展 示 的 示例 ， 局 动 Spring 中 的 RMI 服 
务 并 没有 多 余 的 操作 ， 仅 仅 是 开 司 Spring 的 环境 : 
new 
ClassPathXmlApplicationContext("test/remote/RMISer 
仅 此 一 句 。 于 是 ， 我 们 分 析 很 可 能 古 
RMIServiceExportem 在 初始 化 的 时 候 做 了 某 些 操作 
完成 了 问 口 的 发布 功能 ， 那 么 这 些 操作 的 入 口 是 在 
这 个 类 的 哪个 方法 里 面 呢 ? 


进入 这 个 类 ， 痛 先 分 析 这 个 类 的 层次 结构 ， 如 
图 12-1 所 示 。 


tn E 
4 X9 RmiServiceExporter 
4 (9^ RmiBasedExporter 
4 (9^ RemoteInvocationB asedExporter 
4 9^ RemoteExporter 
4 (9^ RemotingSupport 
(9 Object 
4 @ BeanClassLoaderAware 
Q Aware 
Q DisposableBean 
© InitializingBean 














图 12-1 RMIServiceExporter 类 层次 结构 图 


根据 Eclipse 提供 的 功能 ， 我 们 查看 到 了 





RMIServiceExporter 的 层次 结构 图 ， 那 么 从 这 个 层 
次 图 中 我 们 能 得 到 什么 信息 呢 ? 


RMIServiceExporter 实 现 了 Spring 中 几 个 比较 敏 
感 的 接口 : BeanClassLoaderAware、 
DisposableBean. InitializingBean, +, 
DisposableBean 接 口 保 证 在 实现 该 接口 的 bean 销 蝶 
时 调用 其 destroy 方 法 ，BeanClassLoaderAware 接 口 
保证 在 实现 该 接口 的 bean 的 初始 化 时 调用 其 
setBeanClassLoader77iE, {fi InitializingBean# F1 Jl! 
是 保证 在 实现 该 接口 的 bean 初 始 化 时 调用 其 
afterPropertiesSet 方 法 ， 所 以 我 们 推断 
RMIServiceExporter 的 初始 化 函数 入 口 一 定 在 其 
afterPropertiesSet 或 者 setBeanClassLoader 方 法 中 。 
经 过 查看 代码 ， 确 认 afterPropertiesSet 为 
RMIServiceExporter 功 能 的 初始 化 入 口 。 





public void afterPropertiesSet() throws RemoteException { 
prepare 


(0; 
} 


public void prepare() throws RemoteException { 
// 检 查验 证 service 
checkService(); 
if (this.serviceName == null) { 
throw new IllegalArgumentException("Property 'serv 
iceName' is required"); 


























} 
// 如 果 用 户 在 配置 文件 中 配置 了 clientSocketFactory 或 者 serverSo 
cketFactory 的 处 理 



































* 如 果 配 置 中 的 clientSocketFactory 同 时 又 实现 了 RMIServerSoc 
ketFactory 接 口 那么 会 忽略 
* 配置 中 的 serverSocketFactory 而 使 用 clientSocketFactory 代 














$ 


Wh 
if (this.clientSocketFactory instanceof RMIServerSocke 
tFactory) { 
this.serverSocketFactory = (RMIServerSocketFactory 
) this.clientSocketFactory; 


j 


//clientSocketFactoryfllserverSocketFactory 3 FH Em 
么 都 不 出 现 
if ((this.clientSocketFactory !- null && this.serverSo 
cketFactory == null) || 
(this.clientSocketFactory -- null && this.serv 
erSocketFactory !- null)) { 
throw new IllegalArgumentException( 
"Both RMIClientSocketFactory and RMIServer 
SocketFactory or none 
required"); 


j 


/* 
* 如 果 配 置 中 的 registryClLientSocketFactory 同 时 实现 了 RMISer 
verSocketFactory 接 口 那 么 
* 会 忽略 配置 中 的 registryServerSocketFactory 而 使 用 registry 
ClientSocketFactory{t# 
*/ 
if (this.registryClientSocketFactory instanceof RMISer 
verSocketFactory) { 
this.registryServerSocketFactory = (RMIServerSocke 
tFactory) this 
.registry ClientSocketFactory; 



























































} 

// 不 允许 出 现 只 配置 [registryServerSocketFactory 却 没有 配置 regi 
stryClientSocketFactory 的 

// 情 况 出 现 

if (this.registryClientSocketFactory == null && this.r 
egistryServerSocket Factory != null) { 

throw new IllegalArgumentException( 
"RMIServerSocketFactory without RMIClientS 








ocketFactory for 
registry not supported"); 


j 


this.createdRegistry - false; 











// 确 定 RMI registry 
if (this.registry == null) ( 
this.registry - getRegistry 








(this.registryHost, this.registryPort, 
this.registryClientSocketFactory, this.registr 
yServerSocketFactory); 
this.createdRegistry - true; 


j 


// 初 始 化 以 及 缓存 导出 的 0bject 

// 此 时 通常 情况 下 是 使 用 RMIInvocationwWrapper 封 装 的 JDK 代 理 类 ， 
切面 为 RemoteInvocation TraceInterceptor 

this.exportedObject = getObjectToExport 


























(0; 


if (logger.isInfoEnabled()) ( 
logger.info("Binding service '" + this.serviceName 
+ "' to RMI registry: " + this.registry); 
J 


// Export RMI object. 
if (this.clientSocketFactory !- null) ( 
/* 
* 使 用 由 给 定 的 套 接 字 工厂 指定 的 传送 方式 导出 远程 对 象 ， 以 便 能 
够 接收 传 入 的 调用 。 
* clientSocketFactory :进行 远程 对 象 调 用 的 客户 端 套 接 字 工 
































E 
* serverSocketFactory :接收 远程 调用 的 服务 端 套 接 字 工厂 
iU 

UnicastRemoteObject.exportObject( 
this.exportedObject, this.servicePort, thi 
s.clientSocketFactory, this.serverSocketFactory); 


else ( 
// 导 出 remote object, 以 使 它 能 接收 特定 端口 的 调用 
UnicastRemoteObject.exportObject(this.exportedObje 
ct, this.servicePort); 


j 


try { 











if (this.replaceExistingBinding) { 
this.registry.rebind(this.serviceName, this.ex 
portedObject); 


else ( 
// 绑 定 服务 名 称 到 remote object. ^N UHserviceName 
的 时 候 会 被 exportedobject 接 收 
this.registry.bind(this.serviceName, this.expo 





rtedObject); 


catch (AlreadyBoundException ex) { 
unexportObjectSilently(); 
throw new IllegalStateException( 
"Already an RMI object bound for name '" 
+ this.serviceName + "': " + ex.toString()); 
} 
catch (RemoteException ex) { 
unexportObjectSilently(); 
throw ex; 





果然 ， 在 afterPropertiesSet 函 数 中 将 实现 委托 给 
了 prepare， 而 在 prepare 方 法 中 我 们 找到 了 RMI 服 务 
发 布 的 功能 实现 ， 同 时 ， 我 们 也 大 致 清楚 了 RMI 服 
务 发 布 的 流程 。 


1. 验证 service。 


此 处 的 service 对 应 的 是 配置 中 类 型 为 
RMIServiceExporter 的 Service 属 性 ， 它 是 实现 类 ， 并 
不 是 接口 。 尽 管 后 期 会 对 RMIServiceExporter 做 一 
系列 的 封装 ， 但 是 ， 无 论 怎 么 封装 ， 最 终 还 是 会 将 


逻辑 引 回 至 RMIJIServiceExporter 来 处 理 ， 所 以 ， 在 
Ax AB ZW m RETI Jur UE e 


2. 人 处理 用 户 上 自 定 义 的 SocketFactory 属 性 。 


在 RMIServiceExporter 中 提供 了 4 个 套 接 字 工 厂 
配置 ， 分 别 是 dientSocketFactory、serverSocket 
Factory AllregistryClientSocketFactory « 
registryServerSocketFactory. AbAIX PAX o E XA 
什么 区 别 或 者 说 分 别 是 应 用 在 什么 样 的 不 同 场景 
HE ? 

















registryClientSocketFactory 与 
registryServerSocketFactory HH + 3: fL E RMIB AS 45 
CARER OE, (bk AH 
LocateRegistry.createRegistry(registry Port, 
clientSocketFactory, server SocketFactory) 方 法 创建 
Registry 实 例 时 会 在 RMI 主 机 使 用 
serverSocketFactory h] E £ fz^r SPER, MARS ig 
与 RMI 主 机 通信 时 会 使 用 clientSocketFactory 创 建 连 
BERG. 


clientSocketFactory. serverSocketFactory |F] FE Z& 
创建 套 接 字 ， 但 是 使 用 的 位 置 不 同 ， 
clientSocketFactory、SserverSocketFactory 用 于 导出 远 
FEXR, serverSocketFactory H] T 4E ARS vin ELEI 








"ESSERE PA mE, miclentSocketFactory H] + val H 
Um e VS eFC UTE FR 


3. AACS XI Registry. 
4. 构造 对 外 发 布 的 实例 。 


构建 对 外 发 布 的 实例 ， 当 外 界 通过 注册 的 服务 
名 调用 响应 的 方法 时 ，RMI 服 务 会 将 请 求 引入 此 类 
来 处 理 。 


5. 发 布 实 例 。 


在 发 布 RMI 服 务 的 流程 中 ， 有 几 个 步骤 可 能 是 
我 们 比较 关心 的 。 


1. 获取 registry 


RMA SABA, ATEN, 
获取 Registry 实 例 是 非常 简单 的 ， 只 需要 使 用 一 个 
K Zt LocateRegistry.createRegistry(...)6!] && Registry 3c 
例 就 可 以 了 。 但 是 ，Spring 中 并 没有 这 么 做 ， 而 是 
考虑 得 更 多 ， 比 如 RMI 注 册 主 机 与 发 布 的 服务 并 不 
在 一 台 机 右上 ， 那 么 需要 使 用 
LocateRegistry.getRegistry(registryHost, registryPort, 
clientSocketFactory) 去 远程 获取 Registry 实 例 。 





protected Registry getRegistry(String registryHost, int registr 
yPort, 

RMIClientSocketFactory clientSocketFactory, RMISer 
verSocketFactory serverSocketFactory) 

throws RemoteException { 


if (registryHost !- null) ( 
// 远 程 连接 测试 
if (logger.isInfoEnabled()) { 
logger.info("Looking for RMI registry at port 
" + registryPort + "' of host [" + registryHost + "]"); 





} 
// 如 果 registryHost 不 为 空 则 尝试 获取 对 应 主机 的 Registry 


Registry reg = LocateRegistry.getRegistry(registry 
Host, registryPort, 
clientSocketFactory); 

testRegistry(reg); 

return reg; 

jelse ( 
// 获 取 本 机 的 Registry 
return getRegistry 


(registryPort, clientSocketFactory, serverSocketFactory); 


J 








如 果 并 不 是 从 另外 的 服务 右上 获取 Registry 连 
接 ， 那 么 就 需要 在 本 地 创建 RMI 的 Registry 实 例 了 。 
当然 ， 这 里 有 一 个 关键 的 参数 
alwaysCreateRegistry， 如 果 此 参数 配置 为 tue， 那 
么 在 获取 Registry 实 例 时 会 首先 测试 是 否 已 经 建立 
了 对 指定 端口 的 连接 ， 如 果 已 经 建立 则 复 用 已 经 创 
建 的 实例 ， 人 否则 重新 创建 。 


当然 ， 之 前 也 提 到 过 ， 创 建 Registry 实 例 时 可 





以 使 用 目 定 义 的 连接 工厂 ， 而 之 前 的 判断 也 保证 了 
clientSocketFactory 与 serverSocketFactory 要 么 同时 出 
现 ， 要 么 同时 不 出 现 ， 所 以 这 里 只 对 
clientSocketFactory 是 售 为 空 进行 了 判断 。 





protected Registry getRegistry( 
int registryPort, RMIClientSocketFactory clientSoc 


ketFactory, RMIServerSocketFactory serverSocketFactory ) 
throws RemoteException ( 


if (clientSocketFactory !- null) { 
if (this.alwaysCreateRegistry) { 
logger.info("Creating new RMI registry"); 
// 使 用 clientSocketFactory 创 建 Registry 
return LocateRegistry.createRegistry(registryP 
ort, clientSocketFactory, serverSocketFactory); 





} 
if (logger.isInfoEnabled()) { 
logger.info("Looking for RMI registry at port 
'" + registryPort + "', using custom socket factory"); 


synchronized (LocateRegistry.class) ( 
try { 

// 复 用 测试 

Registry reg = LocateRegistry.getRegistry( 
null, registryPort, 
clientSocketFactory); 

testRegistry(reg); 

return reg; 


j 


catch (RemoteException ex) { 
logger.debug("RMI registry access threw ex 


ception", ex); 
logger.info("Could not detect RMI registry 


- creating new one"); 
return LocateRegistry.createRegistry(regis 


tryPort,clientSocketFactory, serverSocketFactory); 
} 
} 
jelse { 
return getRegistry 


(registryPort); 
} 





ti Gi e Registry SE Pil IM A s fH] B xe XJ 
EFL , ABAGu UEBER 
LocateRegistry.createRegistry(...)/7 32:3 Gi] ÆT, ~4 
然 复 用 的 检测 还 是 必要 的 。 





protected Registry getRegistry(int registryPort) throws RemoteE 
xception { 
if (this.alwaysCreateRegistry) { 
logger.info("Creating new RMI registry"); 
return LocateRegistry.createRegistry(registryPort ) 


} 
if (logger.isInfoEnabled()) { 
logger.info("Looking for RMI registry at port '" + 
registryPort + "'"); 


synchronized (LocateRegistry.class) ( 
try { 
// 查 看 对 应 当前 registryPort 的 Registry 是 否 已 经 创建 ， 








如 果 创 建 直 接 使 用 
Registry reg = LocateRegistry.getRegistry(regi 
stryPort); 
// Wide cur Hi. unma up p uu ae a 
testRegistry(reg); 
return reg; 





j 


catch (RemoteException ex) { 
logger.debug("RMI registry access threw except 
ion", ex); 
logger.info("Could not detect RMI registry - c 
reating new one"); 
// 根 据 端口 创建 Registry 
return LocateRegistry.createRegistry(registryP 








2. 初始 化 将 要 导出 的 实体 对 象 


之 前 有 提 到 过 ， 当 请 求 某 个 RMI 服 务 的 时 候 ， 
RMI 会 根据 注册 的 服务 名 称 ， 将 请 求 引导 全 远程 对 
象 处 理 类 中 ， 这 个 处 理 类 便 是 使 用 
getObjectToExport() 进 行 创建 。 





protected Remote getObjectToExport() { 

// 如 果 配 置 的 service 属性 对 应 的 类 实现 了 Remote 接 口 且 没 有 配置 serv 
iceInterface 属 性 

if (getService() instanceof Remote && 


(getServiceInterface() -- null || Remote.class 
.isAssignableFrom (get 


ServiceInterface()))) { 
return (Remote) getService(); 














j 


else ( 
if (logger.isDebugEnabled()) { 


logger.debug("RMI service [" + getService() + 
"] is an RMI invoker"); 





// 对 service 进行 封装 
return new RMIInvocationwrapper (getProxyForService 


(), this); 
J 


j 





请 求 处 理 类 的 初始 化 主要 处 理 规则 为 ， 如 果 配 





置 的 service 属 性 对 应 的 类 实现 了 Remote 接 口 且 没 有 
配置 serviceInterface 属 性 ， 那 么 直接 使 用 service 作 为 
处 理 类 ; 否则， 使 用 RMIInvocationWrapper 对 
service 的 代理 类 和 当前 类 也 就 是 RMIServiceExporter 
进行 封装 。 


ZEIT IEA, FF hi BS ABH via BEAT DATA 
一 致 协议 ， 当 客户 端 检 测 到 是 RMIInvocation 
Wrapper 类 型 stub 的 时 候 便 会 直接 调用 其 invoke 方 
法 ， 使 得 调用 应 与 服务 疹 很 好 地 连接 在 了 一 起 。 而 
RMIInvocationWrapper 封 装 了 用 于 处 理 请 求 的 代理 
类 ， 在 invoke 中 便 会 使 用 代理 类 进行 进一步 处 理 。 


之 前 的 逻辑 已 经 非常 清楚 了 ， 当 请 求 RMI 服 务 
时 会 由 注册 表 Registry 实 例 将 请 求 转 同 之 前 注册 的 
处 理 类 去 处 理 ， 也 就 是 之 前 封闭 的 
RMIInvocationWrapper， 然 后 由 
RMIInvocationWrapper 中 的 invoke 方 法 进行 处 理 ， 
那么 为 什么 不 是 在 invoke 方 法 中 直接 使 用 service， 
而 是 通过 代理 再 次 将 service 封 装 呢 ? 


这 其 中 的 一 个 关键 点 是 ， 在 创建 代理 时 添加 了 
一 个 增强 拦截 器 RemoteInvocationTraceInterceptor， 
目的 是 为 了 对 方法 调用 进行 打印 跟踪 ， 但 是 如 条 和 直 
接 在 invoke 方 法 中 硬 编 码 这 些 日 过， 会 使 代码 看 起 
来 很 不 优雅 ， 而 且 耦 合 度 很 高 ， 使 用 代理 的 方式 就 














会 解决 这 样 的 问题 ， 而 且 会 有 很 高 的 可 扩展 性 。 


protected Object getProxyForService() { 
// 验 证 service 
checkService(); 
// 验 证 serviceInterface 
checkServiceInterface( ) ; 




















// 使 用 JDK 的 方式 创建 代理 
ProxyFactory proxyFactory - new ProxyFactory(); 
// 添 加 代理 接口 
proxyFactory.addInterface(getServiceInterface()); 


























if (this.registerTraceInterceptor !- null ? 
this.registerTracelInterceptor.booleanValue() 
this.interceptors -- null) ( 
// 加 入 代理 的 横 切 面 RemoteInvocationTraceInterceptor 并 记 
录 Exporter 名 称 
proxyFactory.addAdvice(new RemoteInvocationTraceIn 





























terceptor 


(getExporterName())); 


if (this.interceptors !- null) ( 

AdvisorAdapterRegistry adapterRegistry - GlobalAdv 
isorAdapterRegistry. 
getInstance(); 

for (int i = 0; i < this.interceptors.length; i++) 

{ 
proxyFactory.addAdvisor(adapterRegistry.wrap(t 

his.interceptors[i])); 




















} 

// 设 置 要 代理 的 目标 类 
proxyFactory.setTarget(getService()); 
proxyFactory.setOpaque(true); 























// 创 建 代理 
return proxyFactory.getProxy(getBeanClassLoader()); 








3. RMIHI 服 务 激 活 调用 





之 前 反复 提 到 过 ， 由 于 在 之 前 bean 初 始 化 的 时 
候 做 了 服务 名 称 绑 定 this.registry.bind 
(this.serviceName, this.exportedObject)， 其 中 的 
exportedObject 其 实 是 被 RMIInvocationWrapper 进 行 
WEA, tate th SARIS 28 Vil H serviceName 
的 RMI 服 务 时 ，Java 会 为 我 们 封装 其 内 部 操作 ， 而 
直接 会 将 代码 转向 RMIInvocationWrapper 的 invoke 
THIEF 





public Object invoke(RemoteInvocation invocation) 

throws RemoteException, NoSuchMethodException, Illegal 
AccessException, 
InvocationTargetException { 


return this.RMIExporter.invoke 


(invocation, this.wrappedObject); 


j 





而 此 时 this.RMIExporter 为 之 前 初始 化 的 
RMIServiceExporter，invocation 为 包含 着 需要 激活 
的 方法 参数 ， 而 wrappedObject 则 是 之 前 封装 的 代理 


X, 








protected Object invoke(RemoteInvocation invocation, Object tar 
getObject) 


throws NoSuchMethodException, IllegalAccessExcepti 
on, InvocationTargetException { 


return super.invoke 


(invocation, targetObject); 


j 


protected Object invoke(RemoteInvocation invocation, Object tar 
getObject) 

throws NoSuchMethodException, IllegalAccessExcepti 
on, InvocationTargetException { 


if (logger.isTraceEnabled()) { 
logger.trace("Executing " + invocation); 
} 


try { 
return getRemoteInvocationExecutor().invoke 


(invocation, targetObject); 
} 
catch (NoSuchMethodException ex) { 
if (logger.isDebugEnabled()) { 
logger.warn("Could not find target method for 
" * invocation, ex); 
} 
throw ex; 
} 
catch (IllegalAccessException ex) { 
if (logger.isDebugEnabled()) { 
logger.warn("Could not access target method fo 
r " + invocation, ex); 
} 
throw ex; 
} 
catch (InvocationTargetException ex) { 
if (logger.isDebugEnabled()) { 
logger.debug("Target method failed for " + inv 
ocation, ex.getTargetException()); 


j 


throw ex; 


j 


public Object invoke(Remotelnvocation invocation, Object target 
Object) 
throws NoSuchMethodException, IllegalAccessExcepti 


on, InvocationTargetException{ 


Assert.notNull(invocation, "RemoteInvocation must not 
be null"); 
Assert.notNull(targetObject, "Target object must not b 
e null"); 
// 通 过 反射 方式 激活 方法 
return invocation.invoke 








(targetObject); 


public Object invoke(Object targetObject) 
throws NoSuchMethodException, IllegalAccessExcepti 

on, InvocationTarget 
Exception ( 

// 根 据 方法 名 称 获 取代 理 中 对 应 的 方法 

Method method = targetObject.getClass().getMethod(this 
.methodName, this. 
parameterTypes); 

// 执 行 代理 中 的 方法 


return method.invoke(targetObject, this.arguments); 












































12.1.3 ”客户 端 实 现 


根据 客户 端 配置 文件 ， 锁 定 入 口交 为 
RMIProxyFactoryBean， 同 样 根据 类 的 层次 结构 得 
找 入 口 函 数 ， 如 图 12-2 所 示 。 





"S [uS E 
„D RmiProxyFactoryB ean 
Tc) RmiClientinterceptor 
4 (9^ RemotelnvocationB asedAccessor 
4 (9^ UrlBasedRemoteAccessor 
4 o^ RemoteAccessor 
4 (9^ RemotingSupport 
(9 Object 
4 © BeanClassLoaderAware 
Q Aware 
@ InitializingBean 
4 €) Methodinterceptor 
4 © Interceptor 
@ Advice 
4 @ BeanClassLoaderAware 
Q Aware 
Q FadoryBean<T> 





图 12-2 RMIProxyFactoryBean 类 的 层次 结构 图 


根据 层次 关系 以 及 之 前 的 分 析 ， 我 们 提取 出 该 
类 实现 的 比较 重要 的 接口 InitializingBean、 
BeanClassLoaderA ware LA /7 MethodInterceptor. 








其 中 实现 了 nitializingBean， 则 Spring 会 确保 在 
此 初始 化 bean 时 调用 afterPropertiesSet 进 行 逻 辑 的 初 
始 化 。 





public void afterPropertiesSet() ( 
super.afterPropertiesSet(); 


if (getServiceInterface() == null) { 
throw new IllegalArgumentException("Property 'serv 
icelnterface' is required"); 























} 
// 根 据 设 置 的 接口 创建 代理 ， 并 使 用 当前 类 this 作 为 增强 器 
this.serviceProxy = new ProxyFactory(getServiceInterfa 
ce(), this).getProxy 
(getBeanClassLoader()); 











同时 ，RMIProxyFactoryBean 又 实现 了 
FactoryBean 接 口 ， 那 么 当 获 取 bean 时 并 不 是 直接 获 
取 bean， 而 是 获取 该 bean 的 getObject 方 法 。 


public Object getObject() { 
return this.serviceProxy; 
} 


eRe, BUM CORE X TPKE, 
当 获 取 该 bean 时 ， 首 先 通 过 afterPropertiesSet 创 建 代 
理 类 ， 并 使 用 当前 类 作为 增强 方法 ， 而 在 调用 该 
bean 时 其 实 返回 的 是 代理 类 ， 既 然 调 用 的 是 代理 
类 ， 那 么 又 会 使 用 当前 bean 作 为 增强 器 进行 增强 ， 
也 就 是 说 会 调用 RMIProxy FactoryBean 的 父 类 
RMIClientInterceptor 的 invoke 方 法 。 


我 们 先 从 afterPropertiesSet 中 的 
super.afterPropertiesSet() 方 法 开始 分 析 。 


public void afterPropertiesSet() ( 
super.afterPropertiesSet(); 





prepare 


0; 


ARBER, RURAL, WE 
UrlBasedRemoteA ccessor T! HJafterPropertiesSet77 72; 
只 完成 了 对 serviceUrl 属 性 的 验证 。 


public void afterPropertiesSet() { 
if (getServiceUrl() -- null) ( 
throw new IllegalArgumentException("Property 'serv 
iceUrl' is required"); 


j 


j 








Hr EET PIE IS 2% iB DY E prepare77 14: rH 
实现 ， 继 续 查 看 prepare()。 


1. 通过 代理 拦截 并 获取 stub 





在 父 类 的 afterPropertiesSet 方 法 中 完成 了 对 
serviceUrl 的 验证 ， 那 么 prepare 函 数 义 完成 了 什么 功 
能 呢 ? 





public void prepare() throws RemoteLookupFailureException { 
// Cache RMI stub on initialization? 








// 如 果 配 置 了 lookupStubonStartup 属 性 便 会 在 启动 时 寻找 stub 
if (this.lookupStubOnStartup) ( 








Remote remoteObj - lookupStub 


if (logger.isDebugEnabled()) (1 
if (remoteObj instanceof RMIInvocationHandler) 


logger.debug("RMI stub [" + getServiceUr1( 
) + "] is an RMI invoker"); 


else if (getServiceInterface() != null) { 
boolean isImpl = getServiceInterface().isI 
nstance(remoteObj); 
logger.debug("Using service interface [" + 
getServicelnterface(). getName() + 
"] for RMI stub [" + getServiceUrl() + 
"| a " + 
(!isImpl ? "not " : "") + "directly im 
plemented"); 
} 


if (this.cacheStub) { 
// 将 获取 的 stub 缓 存 
this.cachedStub = remoteObj; 





从 上 面 的 代码 中 ， 我 们 了 解 到 了 一 个 很 重要 的 
属性 lookupStubOnStartup， 如 果 将 此 属性 设置 为 
true， 那 么 获取 stub 的 工作 就 会 在 系统 局 动 时 被 执行 








并 缓存 ， 从 而 提高 使 用 时 候 的 啊 应 时 间 。 


获取 stub 征 RMI 应 用 中 的 关键 步 又， 当然 你 可 
以 使 用 两 种 方式 进行 。 


。 使 用 自 定义 的 套 接 字 工厂。 如 果 使 用 这 种 方 








式 ， 你 需要 在 构造 Registry 实 例 时 将 自 定义 套 接 
字 工 厂 传 入 ， 并 使 用 Registry 中 提供 的 lookup 方 
法 来 获取 对 应 的 stub。 

。 直 接 使 用 RMI 提 供 的 标准 方法 : 
Naming.lookup(getServiceUrl()). 








protected Remote lookupStub() throws RemoteLookupFailureExcepti 
on { 


try { 
Remote stub - null; 


if (this.registryClientSocketFactory !- null) { 


URL url - new URL(null, getServiceUrl(), new D 
ummyURLStreamHandler()); 

String protocol - url.getProtocol(); 

// 验 证 传输 协议 

if (protocol !- null && !"RMI".equals(protocol 





)) i 
throw new MalformedURLException("Invalid U 
RL scheme '" + protocol + is 


} 

// 主 机 

String host = url.getHost(); 

// 端 口 

int port = url.getPort(); 

/ LR AS 

String name - url.getPath(); 

if (name != null && name.startsWith("/")) { 
name - name.substring(1); 

} 

Registry registry = LocateRegistry.getRegistry 

(host, port, this.registry Client SocketFactory); 
stub - registry.lookup(name); 


else ( 
// Can proceed with standard RMI lookup API... 
stub - Naming.lookup(getServiceUrl()); 


} 
if (logger.isDebugEnabled()) { 
logger.debug("Located RMI stub with URL [" + g 


etServiceUrl() + "]"); 
return stub; 


} 
catch (MalformedURLException ex) { 
throw new RemoteLookupFailureException("Service UR 
L [" + getServiceUrl() + "] is invalid", ex); 


catch (NotBoundException ex) { 
throw new RemoteLookupFailureException( 
"Could not find RMI service [" + getServic 
eUrl() + "] in RMI registry", ex); 
} 


catch (RemoteException ex) { 
throw new RemoteLookupFailureException("Lookup of 
RMI stub failed", ex); 
} 


} 





AY f fs HjregistryClientSocketFactory, RI Œ 
比 使 用 RMI 标 准 获 取 stub 方 法 多 出 了 很 多 ， 那 么 
registryClientSocketFactory 到 底 是 做 什么 用 的 呢 ? 


与 之 前 服务 问 的 套 接 字 工 三 类 似 ， 这 里 的 
registryClientSocketFactory H2KXE£ZRMUIKAS- as, FA 
户 通过 实现 RMICjlientSocketFactory 接 口 来 控制 用 于 
连接 的 socket 的 各 种 参数 。 


2. 增强 器 进行 远程 连接 
之 前 分 析 了 类 型 为 RMIProxyFactoryBean 的 


bean 的 初始 化 中 完成 的 馆 辑 操作 。 在 初始 化 时 ， 创 
建 了 代理 并 将 本 身 作 为 增强 硕 加 入 了 代理 中 














(RMIProxyFactoryBean|H] ZZ SC 3l f 
MethodInterceptor) 。 那 么 这 样 一 来 ， 当 在 客户 端 
调用 代理 的 接口 中 的 茶 个 方法 时 ， 残 会 首先 执行 
RMIProxyFactoryBean 中 的 invoke 方 法 进行 增强 。 


public Object invoke(MethodInvocation invocation) throws Throwa 
ble ( 


// 获 取 的 服务 器 中 对 应 的 注册 的 remote 对 象 ， 通 过 序列 化 传输 
Remote stub = getStub 


try { 
return dolInvoke 


(invocation, stub); 
} 
catch (RemoteConnectFailureException ex) { 
return handleRemoteConnectFailure(invocation, ex); 


catch (RemoteException ex) { 
if (isConnectFailure(ex)) { 
return handleRemoteConnectFailure(invocation, 


else ( 
throw ex; 





ARAM Fed RO, 40e Pm f HB ET IT 28] FI T 
ERMI R stub, Aja Hie stubrP S] BS fei 
FARET ARS ae Val, ix^ stub it ce FE ERA ds 
IS ACARI TAR, MWA, RP mH ec EE 7 2 
也 是 进行 stub 的 获取 了 。 








protected Remote getStub() throws RemoteLookupFailureException 


if (!this.cacheStub || (this.lookupStubOnStartup && !this. 
refreshStubOnConnect 
Failure)) { 
// 如 果 有 缓存 直接 使 用 缓存 
return (this.cachedStub !- null ? this.cachedStub : 
lookupStub()); 





else ( 
synchronized (this.stubMonitor) ( 
if (this.cachedStub -- null) ( 
// 获 取 stub 
this.cachedStub = lookupStub(); 


return this.cachedStub; 





当 获 取 到 stub 后 便 可 以 进行 远程 方法 的 调用 
了 。Spring 中 对 于 远程 方法 的 调用 其 实 是 分 两 种 情 
况 考虑 的 。 


。 获 取 的 stub 是 RMIInvocationHandler 类 型 的 ， 从 
服务 端 获取 的 stub 是 RMIInvocation Handler, W 
意味 着 服务 端 也 同样 使 用 了 Spring 去 构建 ， 那 么 
上 自然 会 使 用 Spring 中 作 的 约定 ， 进 行 客户 端 调用 
处 理 。 Spring 中 的 处 理 方式 被 委托 给 了 doInvoke 
pa 

。 当 获取 的 stub 不 ^: RMIInvocationHandler^s 4: 型 ， 
那么 服务 端 构建 RMI 服 务 可 能 是 通过 通 的 方 
法 或 者 借助 于 Spring 外 的 第 三 方 插件 ， 处 理 








oa 自然 会 按照 RMI 中 普通 的 处 理 方式 进行 ， 
这 种 普通 的 处 理 方式 无 非 是 反射 。 因 为 在 
vocation 了 上 所 需要 调用 的 方法 的 各 种 信 
轧 ， 包 括 方法 名 称 以 及 参数 等 ， 而 调用 的 实体 
正 是 stub， 那 么 通过 反射 方法 完全 可 以 激活 stub 
中 的 远程 调用 。 














protected Object doInvoke(MethodInvocation invocation, Remote s 
tub) throws Throwable { 

/Vstub 从 服务 器 传 回 且 经 过 Spring 的 封装 

if (stub instanceof RMIInvocationHandler) { 


try { 
return doInvoke 


(invocation, (RMIInvocationHandler) stub); 


catch (RemoteException ex) { 
throw RMIClientInterceptorUtils.convertRMIAcce 
ssException( 
invocation.getMethod(), ex, isConnectFailu 
re(ex), getServiceUrl()); 


catch (InvocationTargetException ex) { 
Throwable exToThrow = ex.getTargetException(); 
RemoteInvocationUtils.fillInClientStackTraceIf 
Possible(exToThrow) ; 
throw exToThrow; 


} 
catch (Throwable ex) { 
throw new RemoteInvocationFailureException("In 
vocation of method [" + invocation.getMethod() + 
"] failed in RMI service [" + getServi 
ceUrl() + "]", ex); 


j 


else ( 


try { 
// 直 接 使 用 反射 方法 继续 激活 
return RMIClientInterceptorUtils.invokeRemoteM 
ethod(invocation, stub); 





catch (InvocationTargetException ex) { 
Throwable targetEx = ex.getTargetException(); 
if (targetEx instanceof RemoteException) { 
RemoteException rex = (RemoteException) ta 
rgetEx; 
throw RMIClientInterceptorUtils.convertRMI 
AccessException( 
invocation.getMethod(), rex, isCon 
nectFailure(rex), 
getServiceUrl()); 


else ( 
throw targetEx; 








E rm c 出 处 理 RMI 的 
方式 。 其 实 ， 在 分 析 服 务 端 发 布 RMI 的 方式 时 ， 我 





们 已 经 了 解 到 ， Spring 将 RMI 的 导出 Object 封 妆 成 J 
RMIInvocationHandler 类 型 进行 太 布 ， 那 么 当 客 户 
问 获 取 stub 的 时 候 是 包含 了 远程 连接 信息 代理 类 的 
RMIInvocationHandler， 也 束 是 说 当 调 用 
RMIInvocationHandler 中 的 方法 时 会 使 用 RMI 中 提供 
的 代理 进行 远程 连接 ， 而 此 时 ，Spring 中 要 做 的 整 
是 将 代码 引 问 RMIInvocationHandler 接 口 的 invoke 方 
法 的 调用 。 








protected Object doInvoke(MethodInvocation methodInvocation, RM 
IInvocationHandler invocationHandler ) 

throws RemoteException, NoSuchMethodException, Illegal 
AccessException, Invocation TargetException { 


if (AopUtils.isToStringMethod(methodInvocation.getMeth 


od())) 1 
return "RMI invoker proxy for service URL [" + get 
ServiceUrl() + "]"; 





} 
// 将 methodInvocation 中 的 方法 名 及 参数 等 信息 重新 封装 到 RemoteIn 




















vocation， 并 通过 远程 代理 方法 直接 调用 
return invocationHandler.invoke(createRemoteInvocation 
(methodInvocation)); 





12.2 HttpInvoker 


Spring 开 发 小 组 意识 到 在 RMI 服 务 和 基于 HTTP 
的 服务 (如 Hessian 和 Burlap)〉 之 间 的 空 日 。 一 方 
面 ，RMI 使 用 Java 标 准 的 对 象 序列 化 ， 但 很 难 罕 越 
防火 墙 ; 男 一 方面 ，Hessian/Burlap 能 很 好 地 罕 过 防 
~ 但 使 用 目 己 私有 的 一 套 对 象 序 列 化 机 
Ja 


就 这 样 ，Spring 的 HttpInvoker 心 运 而 生 。 
HttpInvoker 是 一 个 新 的 远程 调用 模型 ， 作 为 Spring 
框架 的 一 部 分 ， 来 执行 基于 HTTP 的 远程 调用 (让 
防火 墙 高 兴 的 事 ) ， 并 使 用 Java 的 序列 化 机 制 ( 这 
是 让 程序 员 高 兴 的 事 ) 。 


我 们 首先 看 看 HttpInvoker 的 使 用 示例 。 
HttpInvoker 古 基于 HTTP 的 远程 调用 ， 同 时 也 古 使 























用 Spring 中 提供 的 web 服 务 作为 基础 ， 所 以 我 们 的 
测试 需要 首先 搭建 Web 工 程 。 








12.2.4 使 用 示例 


1. 创建 对 外 接口 


public interface HttpInvokerTestI { 


public String getTestPo(String desp); 
} 





2. 创建 接口 实现 类 


public class HttpInvokertestlImpl implements HttpInvokerTestI { 


QOverride 
public String getTestPo(String desp) { 
return "getTestPo " + desp; 


j 





3. 创建 服务 端 配置 文件 applicationContext- 
server.xml 





<?xml version="1.0" encoding="UTF-8"?> 
«beans xmlns="http://www.Springframework.org/schema/beans" 
xmins:xsi="http: //www.w3.org/2001/XMLSchema- instance" 


xsi:schemaLocation-z" 
http://www.Springframework.org/schema/beans 
http://www.Springframework.org/schema/beans/Spring-beans-3.0.xs 
d Ws 


<bean name="httpinvokertest" class="test.HttpInvokertestiIm 
pl" /> 
</beans> 





4. TEWEB-INF F 8| £&remote-servlet.xml 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-z" 

http://www.Springframework.org/schema/beans 

http://www.Springframework.org/schema/beans/Spring-beans-3.0.xs 

d Ws 


<bean name="/hit" 
class="org.Springframework. remoting. httpinvoker.HttpIn 
vokerServiceExporter"> 


«property name="Service" ref="httpinvokertest" /> 
«property name="ServiceInterface" value="test.HttpInvo 
kerTestI" /> 
</bean> 


</beans> 





至 此 ， 服 务 问 的 httpInvoker 服 务 已 经 搭建 完 
了 ， 局 动 Web 工 程 后 就 可 以 使 用 我 们 搭建 的 
HttpInvoker 服 务 了 。 以 上 代码 实现 了 将 远程 传 入 的 
字符 串 参 数 处 理 加 入 “getTestPo” 前 缀 的 功能 。 服 务 
端 搭建 完 基 于 Web 服务 的 HttpInvoker 后 ， 客 户 端 还 








需要 使 用 一 定 的 配置 才能 进行 远程 调用 。 
5. 创建 测试 闹 配 置 client.xml 


<?xml version="1.0" encoding="UTF-8"?> 

«beans xmlns="http://www.Springframework.org/schema/beans" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xSi:schemaLocation=" 

http://www. Springframework.org/schema/beans 

http://www. Springframework.org/schema/beans/Spring-beans-3.0.xs 

d Ws 


<bean id="remoteService" 
class="org.Springframework. remoting. httpinvoker.HttpIn 


vokerProxyFactoryBean"> 

«property name="ServiceUrl" value="http://localhost: 80 
80/httpinvokertest/ 
remoting/hit" /> 

«property name="ServiceInterface" value="test.HttpInvo 
kerTestI" /> 


</bean> 
</beans> 





6. 创建 测试 类 





public class Test { 
public static void main(String[] args) { 

ApplicationContext context = new ClassPathXmlApplica 

tionContext ("classpath: client.xml"); 
HttpInvokerTestI httpInvokerTestI = (HttpInvokerTest 

I) context.getBean 

("remoteService"); 
System.out.println(httpInvokerTestlI.getTestPo("dddd" 


)); 
} 


j 


Pt 


运行 测试 类 ， 你 会 看 到 打印 结果 : 


getTestPo dddd 


dddd 是 我 们 传 入 的 参数 ， 而 getTestPo 则 是 在 服 
务 端 添加 的 字符 串 。 当 然 ， 上 面 的 服务 搭建 与 测试 
过 程 中 都 是 在 一 台 机 器 上 进行 的 ， 如 果 需 要 在 不 同 
机 右上 进行 测试 ， 还 需要 读者 对 服务 端的 相关 接口 
打 成 JAR 包 并 加 入 到 客户 端的 服务 右上 。 














12.2.2 ”服务 端 实现 


对 于 Spring 中 HttpInvoker 服 务 的 实现 ， 我 们 还 
是 首先 从 服务 端 进行 分 析 。 

根据 remote-servlet.xml 中 的 配置 ， 我 们 分 析 入 
口 类 应 该 为 org.Springframework.remoting. 


httpinvoker.HttpInvokerServiceExporter， 那 么 同样 ， 
根据 这 个 类 分 析 其 入 口 函 数 ， 如 图 12-3 所 示 。 








*t: (Ad) te: El ~ 
4 K9 HttpInvokerServiceExporter 
4 (9^ RemoteInvocationSerializingExporter 
4 (9^ RemoteInvocationBasedExporter 
2 (9^ RemoteExporter 
4 (9^ RemotingSupport 
(9 Object 
4 @ BeanClassLoaderAware 
Q  Aware 
@ InitializingBean 
Q HttpRequestHandler 








图 12-3 ”HttpInvokerServiceExporter 类 的 层次 结构 图 


通过 层次 关系 我 们 看 到 HttpInvokerService 
Exporter 类 实现 了 InitializingBean 接 口 以 及 Http 
RequestHandler 接 口 。 分 析 RMI 服 务 时 我 们 已 经 了 
解 到 了 ， 当 某 个 bean 继 承 自 InitializingBean 接 口 的 
时 候 ，Spring 会 确保 这 个 bean 在 初始 化 时 调用 其 
afterPropertiesSet 方 法 ， 而 对 于 HttpRequestHandler 
接口 ， 因 为 我 们 在 配置 中 已 经 将 此 接口 配置 成 Web 
服务 ， 那 么 当 有 相应 请 求 的 时 候 ，Spring 的 Web 服 
Fe PEP 9| 5 2 HttpRequestHandlerff] 
handleRequest 方 法 中 。 首 先 ， 我 们 从 
afterPropertiesSet 方 法 开始 分 析 ， 看 看 在 bean 的 初始 
化 过 程 中 做 了 哪些 逻辑 。 








1. 创建 代理 





public void afterPropertiesSet() ( 
prepare 


0; 
} 


public void prepare() { 
this.proxy = getProxyForService 


(); 
} 


protected Object getProxyForService() { 
// 验 证 service 
checkService(); 
// y uEserviceInterface 
checkServiceInterface(); 























// 使 用 JDK 的 方式 创建 代理 
ProxyFactory proxyFactory = new ProxyFactory(); 
// 添 加 代理 接口 
proxyFactory.addInterface(getServiceInterface()); 


















































if (this.registerTraceInterceptor !- null ? 
this.registerTracelInterceptor.booleanValue() 
this.interceptors -- null) ( 
// 加 入 代理 的 横 切 面 RemoteInvocationTraceInterceptor 并 记 
录 Exporter 名 称 
proxyFactory.addAdvice(new RemoteInvocationTraceIn 
terceptor 
(getExporter 
Name())); 
if (this.interceptors != null) { 
AdvisorAdapterRegistry adapterRegistry = GlobalAdv 
isorAdapterRegistry. 


getInstance(); 
for (int i = 0; i < this.interceptors.length; i++) 
{ 
proxyFactory.addAdvisor(adapterRegistry.wrap(t 
his.interceptors[i])); 


y 




















// 设 置 要 代理 的 目标 类 
proxyFactory.setTarget(getService()); 
proxyFactory.setOpaque(true); 

















// 创 建 代理 
return proxyFactory.getProxy(getBeanClassLoader()); 











通过 将 上 面 3 个 方法 串联 ， 可 以 看 到 ， 初 始 化 
过 程 中 实现 的 多 辑 主要 是 创建 了 一 个 代理 ， 代 理 中 





封装 了 对 于 特定 请 求 的 处 理 方法 以 及 接口 等 信息 ， 
而 这 个 代理 的 最 关键 目的 是 加 入 了 
RemoteInvocationTraceInterceptor 增 强占 ， 当 然 创建 
代理 还 有 些 其 他 好 处 ， 比 如 代码 优雅 、 方 便 扩 展 
等 。RemoteInvocationTraceInterceptor 中 的 增强 主要 
是 对 增强 的 目标 方法 进行 一 些 相 关 信息 的 日 志 打 
印 ， 并 没有 在 此 基础 上 进行 任何 功能 性 的 增强 。 那 
么 这 个 代理 究竟 是 在 什么 时 候 使 用 的 呢 ? 暂时 留 下 
巧 念 ， 我 们 接 下 来 分 析 当 有 Web 请 求 时 
HttpRequestHandler 的 handleRequest 方 法 的 处 理 。 











2. AbD A in request 


当 有 有 Web 请求 时 ， 根 据 配 置 中 的 规则 会 把 路 径 
匹配 的 访问 直接 引入 对 应 的 HttpRequest Handler 
中 。 本 例 中 的 Web 请 求 与 普通 的 Web 请 求 是 有 些 区 
列 的 ， 因 为 此 处 的 请 求 包 含 看 HttpInvoker 的 处 理 过 





public void handleRequest(HttpServletRequest request, HttpServl 
etResponse response) 
throws ServletException, IOException { 


try { 
// request tri BUT FU] S 


Remotelnvocation invocation - readRemoteInvocation 


(request); 

/ / 3447 8] FA 

RemotelnvocationResult result - invokeAndCreateRes 
ult 


(invocation, getProxy()); 
// 将 结果 的 序列 化 对 象 写 入 输出 流 


writeRemoteInvocationResult 





(request, response, result); 


catch (ClassNotFoundException ex) { 
throw new NestedServletException("Class not found 
during deserialization", ex); 
} 
} 





在 handlerRequest 水 数 中 ， 我 们 很 清楚 地 看 到 了 
HttpInvoker 处 理 的 大 致 框架 ，HttpInvoker 服 务 人 简单 
点 说 束 是 将 请 求 的 方法 ， 也 束 是 RemoteInvocation 
对 象 ， 从 客户 端 序列 化 并 通过 Web 请 求 出 入 服务 
端 ， 服 务 羡 在 对 传 过 来 的 序列 化 对 象 进行 反 序列 化 
还 原 RemoteInvocation 实 例 ， 然 后 通过 实例 中 的 相 
关 信 息 进 行 相关 方法 的 调用 ， 并 将 执行 结果 再 次 的 
返回 给 客户 端 。 从 handleRequest 函 数 中 我 们 也 可 以 








清晰 地 看 到 程序 执行 的 框架 结构 。 
1. Mrequest 132 BUT WILT RR - 


主要 是 从 HttpServletRequest 提 取 相 关 的 信息 ， 
也 就 是 提取 HttpServletRequest 中 的 RemoteInvocation 


对 象 的 序列 化 信息 以 及 反 序 列 化 的 过 程 。 











protected RemoteInvocation readRemoteInvocation(HttpServletRequ 
est request) 


throws IOException, ClassNotFoundException { 
return readRemoteInvocation 


(request, request.getInputStream()); 


J 


protected Remotelnvocation readRemoteInvocation(HttpServletRequ 
est request, InputStream is) 
throws IOException, ClassNotFoundException ( 
// 创 建 对 象 输入 流 
ObjectinputStream ois = createObjectInputStream(decora 
telnputStream(request, is)); 





try { 
// 从 输入 流 中 读 取 序列 化 对 象 
return doReadRemoteInvocation 
(ois); 
} 
finally { 
ois.close(); 
} 
} 


protected RemoteInvocation doReadRemoteInvocation(ObjectInputSt 
ream ois) 
throws IOException, ClassNotFoundException { 


Object obj = ois.readObject(); 
if (!(obj instanceof RemoteInvocation)) { 


throw new RemoteException("Deserialized object nee 
ds to be assignable to type [" + 
RemoteInvocation.class.getName() + "]: " + 
obj); 


return (RemoteInvocation) obj; 





对 于 序列 化 提取 与 转换 过 程 其 实 并 没有 太 多 需 
要 解释 的 东西 ， 这 里 完全 是 按照 标准 的 方式 进行 操 
作 ， 包 括 创 建 ObjectInputStream 以 及 从 





ObjectInputStream 中 提取 对 象 实例 。 
2. 执行 调用 。 


根据 有 反 序列 化 方式 得 到 的 RemoteInvocation 对 
象 中 的 信息 ， 进 行 方法 调用 。 注 意 ， 此 时 调用 的 实 
体 并 不 是 服务 接口 或 者 服务 类 ， 而 是 之 前 在 初始 化 
时 候 构造 的 封装 了 服务 接口 以 及 服务 类 的 代理 。 


完成 了 RemoteInvocation 实 例 的 提取 ， 也 就 总 
味 着 可 以 通过 RemoteInvocation 实 例 中 提供 的 信息 
进行 方法 调用 了 。 

















protected RemoteInvocationResult invokeAndCreateResult(RemoteIn 
vocation invocation, Object targetObject) { 

















try { 
// 激 活 代理 类 中 对 应 jnvocation 中 的 方法 
Object value = invoke 








(invocation, targetObject); 








// 封 装 结 末 以 便于 序列 化 


return new RemoteInvocationResult(value); 


catch (Throwable ex) 
return new RemotelInvocationResult(ex); 


j 
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对 应 方法 的 激活 也 就 是 mvoke 方 法 的 调用 ， 虽 然 





经 过 层 层 环绕 ， 但 是 最 终 还 是 实现 了 一 个 我 们 
ZV LY) Val Hjinvocation.invoke(targetObject), tH yù 
是 执行 RemoteInvocation 类 中 的 invoke 方 法 ， 大 
致 的 逻辑 还 是 通过 RemoteInvocation 中 对 应 的 方 
法 信息 在 targetObject 上 去 执行 ， 此 方法 在 分 析 
RMI 功 能 的 时 候 已 经 分 析 过 ， 不 再 性 述 。 但 是 
在 对 于 当前 方法 的 targetObject 参 数 ， 此 
targetObject 是 代理 类 ， 调 用 代理 类 的 时 候 需 要 
考虑 增强 方法 的 调用 ， 这 是 读者 需要 注意 的 地 
car 

对 于 返回 结果 需要 使 用 RemoteInvocationResult 
进行 封装 ， 之 所 以 需要 通过 使 用 
RemoteInvocationResult 类 进行 封装 ， 是 因为 无 
法 保证 对 于 所 有 操作 的 返回 结果 都 继承 
Serializable 接 口 ， 也 就 是 说 无 法 保证 所 有 返回 结 
条 都 可 以 直接 进行 序列 化 ， 那 么 ， 融 必须 使 用 
RemoteInvocationResult 类 进行 统一 封装 。 























3. AGRA POT CSS As HA DR o 
同样 这 里 也 包括 结果 的 序列 化 过 程 。 


protected void writeRemoteInvocationResult( 
HttpServletRequest request, HttpServletResponse re 
sponse, Remotelnvocation Result result) throws IOException { 


response.setContentType(getContentType( )); 
writeRemotelnvocationResult 


(request, response, result, response.getOutputStream()); 


j 


protected void writeRemoteInvocationResult( 
HttpServletRequest request, HttpServletResponse re 
sponse, RemoteInvocation 
Result result, OutputStream os) 
throws IOException { 
// 获 取 输 入 流 
ObjectOutputStream oos = createObjectOutputStream(deco 
rateOutputStream(request, 
response, 0s)); 
try { 
// 将 序列 化 对 象 写 入 输入 流 
dowriteRemoteInvocationResult 


(result, oos); 
} 
finally { 
oos.close(); 
} 
} 


protected void doWriteRemoteInvocationResult (RemoteInvocationRe 
sult result, ObjectOutput 
Stream oos)throws IOException { 


oos.writeObject(result); 





12.2.3 客户 端 实 现 


分 析 了 服务 端的 解析 以 及 处 理 过 程 后 ， 我 们 接 

下 来 分 析 客 户 端 的 调用 过 程 ， 在 服务 端 调用 的 分 析 
中 我 们 反复 提 到 需要 从 HttpServletRequest 中 提取 从 
客户 端 传 来 的 RemoteInvocation 实 例 ， 然 后 进行 相 
应 解析 。 所 以 ， 在 客户 问 ， 一 个 比较 重要 的 任务 整 
是 构建 RemoteInvocation 实 例 ， 并 传送 到 服务 端 。 
根据 配置 文件 中 的 信息 ， 我 们 还 是 首先 锁定 
HttpInvokerProxyFactoryBean 类 ， 并 查看 其 层次 结 


构 ， 如 图 12-4 所 示 。 
"^ [un El ~ 


4 K9 HttpInvokerProxyFactoryBean 
.© HttpInvokerClientInterceptor 
4 (9^ RemoteInvocationB asedAccessor 
4 (9^ UrlBasedRemoteAccessor 
E (^ RemoteAccessor 
4 (9^ RemotingSupport 
(9 Object 
4 © BeanClassLoaderAware 
Q  Aware 
@ InitializingBean 
Q HttpInvokerClientConfiguration 
4 €) Methodinterceptor 
4 © Interceptor 
@ Advice 
Q FactoryBean<T= 

















图 12-4 ”HttpInvokerProxyFactoryBean 类 的 层次 结构 图 





从 层次 结构 中 我 们 看 到 ，HttpInvokerProxy 
FactoryBean 类 同样 实现 了 InitializingBean 接 口 。 同 
时 ， 又 实现 了 FactoryBean 以 及 MethodInterceptor。 
这 已 经 是 老生 党 谈 的 问题 了 ， 实 现 这 几 个 接口 以 及 
这 几 个 接口 在 Spring 中 会 有 什么 作用 就 不 再 获 述 
了 ， 我 们 还 是 根据 实现 的 InitializingBean 接 口 分 析 
初始 化 过 程 中 的 逻辑 。 





public void afterPropertiesSet() ( 
super.afterPropertiesSet(); 
if (getServiceInterface() == null) { 
throw new IllegalArgumentException("Property 'serv 
icelnterface' is required"); 


























} 
// 创 建 代理 并 使 用 当前 方法 为 拦截 器 增强 
this.serviceProxy = new ProxyFactory(getServiceInterfa 
ce(), this).getProxy 
(getBeanClassLoader()); 











在 afterPropertiesSet 中 主要 创建 了 一 个 代理 ， 该 
代理 封 狼 了 配置 的 服务 接口 ， 并 使 用 当前 类 也 就 是 
HttpInvokerProxyFactoryBean 作 为 增强 。 因 为 
HttpInvokerProxyFactoryBean 实 现 了 
MethodInterceptor 方 法 ， 所 以 可 以 作为 增强 拦截 
fit o 


同样 ， 又 由 于 HttpInvokerProxyFactoryBean 实 
现 了 FactoryBean 接 口 ， 所 以 通过 Spring 中 普通 方式 
调用 该 bean 时 调用 的 并 不 是 该 bean 本 里 ， 而 是 此 类 


"HgetObject/; iR [REB SEA], ate S wl tow ee 
所 创建 的 代理 。 


public Object getObject() ( 
return this.serviceProxy; 
} 


那么 ， 综 合 之 前 的 使 用 示例 ， 我 们 再 次 回顾 一 
下 ，HttpInvokerProxyFactoryBean 类 型 bean 在 初始 化 
过 程 中 创建 了 封装 服务 接口 的 代理 ， 并 使 用 上 自 吴 作 
为 增强 拦截 器 ， 人 然后 义 因为 实现 了 FactoryBean 接 
口 ， 所 以 获取 Bean 的 时 候 返 回 的 其 实 是 创建 的 代 
理 。 那 么 ， 汇 总 上 面 的 逻辑 ， 当 调用 如 下 代码 时 ， 
其 实 是 调用 代理 类 中 的 服务 方法 ， 而 在 调用 代理 类 
中 的 服务 万 流 时 义 会 使 用 代理 类 中 加 入 的 增强 右 进 
行 增强 。 








ApplicationContext context = new ClassPathXmlApplicationContext 
("classpath:client.xml"); 
HttpInvokerTestI httpInvokerTestI = (HttpInvokerTestI) context. 


getBean("remoteService"); 
System.out.println(httpInvokerTestI.getTestPo("dddd")); 





这 时 ， 所 有 的 网 辑 分 析 其 实 已 经 被 转 同 了 对 于 
Jn on as tH, at z= Http nvokerProxyFactory Bean2 A. Ff 
的 invoke 方 法 的 分 析 。 


在 分 析 invoke 方 法 之 前 ， 其 实 我 们 已 经 猜 出 了 











该 方法 所 提供 的 主要 功能 就 是 将 调用 信息 封装 在 
RemoteInvocation 中 ， 发 送 给 服务 端 并 等 待 返 回 结 
-A 


public Object invoke(MethodInvocation methodInvocation) throws 
Throwable { 
if (AopUtils.isToStringMethod(methodInvocation.getMeth 


od())) { 
return "HTTP invoker proxy for service URL [" + ge 
tServiceUrl() + "]"; 








} 

// 将 要 调用 的 方法 封装 为 RemoteInvocation 

RemoteInvocation invocation = createRemoteInvocation(m 

ethodInvocation); 

RemoteInvocationResult result = null; 

try { 
// 远 程 执行 方法 
result = executeRequest 





(invocation, methodInvocation); 


} 
catch (Throwable ex) { 
throw convertHttpInvokerAccessException(ex); 
} 
try { 
// 提 取 结 果 


return recreateRemoteInvocationResult(result); 





} 
catch (Throwable ex) { 
if (result.hasInvocationTargetException()) { 
throw ex; 


} 
else ( 
throw new RemotelInvocationFailureException("In 
vocation of method [" + methodInvocation.getMethod() + 
"] failed in HTTP invoker remote servi 


ce at [" + getServiceUrl() + "]", ex); 


Jj 
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1. 构建 RemoteInvocation 实 例 . 


因为 是 代理 中 增强 方法 的 调用 ， 调 用 的 方法 及 
参数 信息 会 在 代理 中 封装 至 MethodInvocation 实 例 
中 ， 并 在 增强 方 嚣 中 进行 传递 ， 也 就 意味 着 当 程 序 
进入 invoke 方 法 时 其 实 是 已 经 包含 了 调用 的 接口 的 
相关 信息 的 ， 那 么 ， 首 先 要 做 的 怠 是 将 
MethodInvocation 中 的 信息 提取 并 构建 
RemoteInvocation 实 例 。 








2. 远程 执行 方法 。 
3. 提取 结果 。 


考虑 到 序列 化 的 问题 ， 在 Spring 中 约定 使 用 
HttpInvoker 方 式 进行 远程 方法 调用 时 ， 结 果 使 用 
RemoteInvocationResult 进 行 封装 ， 那 么 在 提取 结果 
后 还 需要 从 封装 的 结果 中 提取 对 应 的 绪 


而 在 这 3 个 步骤 中 最 为 天 键 的 就 是 远程 方法 的 
执行 。 执 行 远程 调用 的 首要 步骤 就 是 将 调用 方法 的 
实例 写 入 输出 流 中 。 














protected RemoteInvocationResult executeRequest( 
RemoteInvocation invocation, MethodInvocation original 
Invocation) throws Exception { 


return executeRequest 
(invocation); 


protected RemotelnvocationResult executeRequest(RemoteInvocatio 
n invocation) throws Exception { 
return getHttpInvokerRequestExecutor().executeRequest 


(this, invocation); 


j 


public final RemoteInvocationResult executeRequest ( 
HttpInvokerClientConfiguration config, RemoteInvocatio 
n invocation) throws 
Exception { 
// 获 取 输 出 流 
ByteArrayOutputStream baos = getByteArrayOutputStream( 
invocation); 
if (logger.isDebugEnabled()) { 
logger .debug("Sending HTTP invoker request for ser 
vice at [" + config.getServiceUrl() + 
"], with size " + baos.size()); 


return doExecuteRequest 


(config, baos); 


j 





在 doExecuteRequest 方 法 中 真正 实现 了 对 远程 
方法 的 构造 与 通信 ， 与 远程 方法 的 连接 功能 实现 
中 ，Spring 引 入 了 第 三 方 JAR: HttpClient. 
HttpClientzé Apache Jakarta Common 下 的 子 项 目 ， 
可 以 用 来 提供 高 效 的 、 最 新 的 、 功 能 丰富 的 文 持 





HTTP 协 议 的 客户 端 编程 工具 包 ， 并 且 它 支持 HTTP 
协议 最 新 的 版 本 和 建议 。 对 HttpClient 的 具体 使 用 方 
法 有 兴趣 的 读者 可 以 参考 更 多 的 资料 和 文档 。 











protected RemoteInvocationResult doExecuteRequest( 
HttpInvokerClientConfiguration config, ByteArrayOu 
tputStream baos) 
throws IOException, ClassNotFoundException { 
//&|s&HttpPost 
HttpPost postMethod - createHttpPost(config); 
// 设 置 含 有 方法 的 输出 流 到 post 中 
setRequestBody(config, postMethod, baos); 
try { 
// 执 行 方法 并 等 待 结果 响应 
HttpResponse response = executeHttpPost(config, ge 
tHttpClient(), postMethod); 
// 验 证 
validateResponse(config, response); 
// 提 取 返 回 的 输入 流 




















InputStream responseBody = getResponseBody(config, 


response); 





// 从 输入 流 中 提取 结果 
return readRemoteInvocationResult(responseBody, co 
nfig.getCodebaseUrl()); 
} 


finally { 
if (releaseConnectionMethod !- null){ 
ReflectionUtils.invokeMethod(releaseConnection 
Method, postMethod); 


Jj 
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1. 创建 HttpPost 





由 于 对 于 服务 端 方法 的 调用 是 通过 Post 方 式 进 
行 的 ， 那 么 自 和 完 要 做 的 束 是 构建 HttpPost， 构 建 
HttpPost 过 程 中 可 以 设置 一 些 必要 的 参数 。 





protected PostMethod createPostMethod(HttpInvokerClientConfigur 
ation config) throws 
IOException { 
// 设 置 需要 访问 的 ur1l 
PostMethod postMethod = new PostMethod(config.getServi 
ceUr1()); 
LocaleContext locale - LocaleContextHolder.getLocaleCo 
ntext(); 
if (locale !- null) ( 
/ / liiXAccept -Language/&' 
postMethod.addRequestHeader(HTTP HEADER ACCEPT LAN 
GUAGE, StringUtils. toLanguageTag(locale.getLocale())); 





pE 





if (isAcceptGzipEncoding()) { 
/ / liiNAccept -Encoding/&' 
postMethod.addRequestHeader(HTTP HEADER ACCEPT ENC 
ODING, ENCODING GZIP); 
} 


return postMethod; 


HE 








ix A RequestBody 


构建 好 PostMethod 实 例 后 便 可 以 将 存储 
RemoteInvocation 实 例 的 序列 化 对 象 的 输出 流 设 置 
进去 ， 当 然 这 里 需要 注意 的 是 传 入 的 ContentType 类 
m, —;jE 224€ Xapplication/x-java-serialized-object VA 
nm 前 解析 时 会 按照 序列 化 对 象 的 解析 方式 进 
行 解析 。 





protected void setRequestBody( 
HttpInvokerClientConfiguration config, PostMethod post 
Method, ByteArrayOutputStream baos) 
throws IOException { 
// 将 序列 化 流 加 入 到 postMethod 中 并 声明 ContentType 类 型 为 applic 
ation/x-java-serialized-object 


postMethod.setRequestEntity(new ByteArrayRequestEntity 
(baos.toByteArray(), getContentType())); 


j 





3. 执行 远程 方法 


通过 HttpClient 所 提供 的 方法 来 直接 执行 远程 广 


protected void executePostMethod( 
HttpInvokerClientConfiguration config, HttpClient 
httpClient, PostMethod postMethod) throws IOException { 
httpClient.executeMethod(postMethod); 
} 





4. 远程 相应 验证 


对 于 HTTP 调 用 的 啊 应 人 码 处 理 ， 大 于 300 则 是 非 
正常 调用 的 啊 应 但 。 





protected void validateResponse(HttpInvokerClientConfiguration 
config, PostMethod postMethod) 
throws IOException { 


if (postMethod.getStatusCode() >= 300) { 
throw new HttpException( 
"Did not receive successful HTTP response: 
status code = " + 
postMethod.getStatusCode() + 
", Status message = [" + postMethod.getSta 
tusText() + "]"); 


| 
5， 提 取 响应 信息 


从 服务 器 返回 的 输入 流 可 能 是 经 过 压缩 的 ， 不 
同 的 方式 采用 不 同 的 办 法 进行 提前 。 


protected InputStream getResponseBody(HttpInvokerClientConfigur 
ation config, PostMethod 
postMethod) 
throws IOException { 


if (isGzipResponse(postMethod)) { 
return new GZIPInputStream(postMethod.getResponseB 
odyAsStream()); 
} 


else { 
return postMethod.getResponseBodyAsStream(); 
} 





6. 所 取 返 回 结 





提取 结 来 的 流程 主要 是 从 输入 流 中 提取 啊 应 的 
序列 化 信息 。 





protected RemoteInvocationResult readRemoteInvocationResult(Inp 
utStream is, String 
codebaseUr1) 

throws IOException, ClassNotFoundException { 


ObjectinputStream ois = createObjectInputStream(decora 


teInputStream(is), 
codebaseUr1); 


try { 
return doReadRemoteInvocationResult(ois); 
} 


finally { 
ois.close(); 


j 





第 13 章 ”Spring 消息 


Java 消 息 服 务 〈Java Message Service, JMS) 
应 用 程序 接口 是 一 个 Java 平 台中 关于 面 同 消 因 中间 
件 (MOM) 的 API， 用 于 在 两 个 应 用 程序 之 间或 分 
ABT RSP AGA, FRET EA. Javaj 
服务 是 一 个 与 具体 平台 无 天 的 API， 绝 大 多 数 MOM 
提供 商都 对 JMS 提 供 文 持 。 


Java 消 妃 服 务 的 规范 包括 两 种 消息 模式 ， 点 对 
扩 和 友 布 者 /订阅 者 。 许 多 提供 两 支持 这 一 通用 框 
架 。 因 此 ， 程 序 员 可 以 在 他 们 的 分 布 式 软件 中 实现 
面 问 消 恩 的 操作 ， 这 些 操作 将 具有 不 同 面 癌 消 恩 中 
间 件 产品 的 可 移植 性 。 


Javaik SARA SC TE lel > Pl re ZP BOTH SAEPE, TE 
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操作 更 加 便利 。 

Java 消 妃 服 务 文 持 面 回 事件 的 方法 接收 消息 ， 
事件 驱动 的 程序 设计 现在 被 广泛 认为 是 一 种 证 有 成 
效 的 程序 设计 范例 ， 程 序 员 们 对 其 部 相当 熟悉 。 























在 应 用 系统 开发 时 ，Java 消 息 服 务 可 以 推迟 选 
择 面 对 消息 中 间 件 产品 ， 也 可 以 在 不 同 的 面 对 浓 居 
中 间 件 之 间 进 行 切换 。 


本 章 以 Java 消 恩 服 务 的 开源 实现 产品 ActiveMQ 
为 例 来 进行 Spring 整合 消息 服务 功能 的 实现 分 析 。 


13.1 JMS 的 独立 使 用 


KERZ% JavaiH SARA HY fs FH S RR 
Spring 相 结合 ， 但 是 ， 我 们 还 是 非 间 有 必要 y EH 
恩 的 独立 使 用 方法 ， 这 对 于 我 们 理解 消息 的 实现 原 
理 以 及 后 续 与 Spring 整合 实现 的 分 析 都 非常 重要 。 
当然 在 消息 服务 的 使 用 前 ， 需 要 先 开 局 消息 服务 
和 项， 如 果 是 Windows 系 统 ， 则 可 以 直接 双击 
ActiveMQ 安 装 目 录 下 bin 目 录 中 的 activemdq.bat 文 件 
来 局 动 消息 服务 器 。 


消 妃 服务 的 使 用 除了 要 开局 消 妃 服务 器 外 ， 还 
需要 构建 消 妃 的 用 送 端 与 接收 顺 ， 发 送 中 主要 用 来 
将 包含 业务 馆 辑 的 消息 发送 至 消息 服务 磺 ， 而 消 奶 
接收 闯 则 用 于 将 服务 夯 中 的 消 轧 提取 并 进行 相应 的 
处 理 。 
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必 送 端 主要 用 于 发 送 消息 到 消息 服务 器 ， 以 下 
为 发 送 消息 测试 ， 和 莹 试 发 送 3 条 消息 到 消息 服务 
器 ， 消 息 的 内 容 为 “大 家 好 这 是 个 测试 ”。 





public class Sender ( 
public static void main(String[] args) throws Exception { 


ConnectionFactory connectionFactory - new ActiveMQConn 
ectionFactory(); 


Connection connection - connectionFactory.createConnec 
tion(); 
//connection.start(); 


Session session - connection.createSession(Boolean.TRU 


Session.AUTO ACKNOWLEDGE); 
Destination destination = session.createQueue("my-queu 
e"); 


MessageProducer producer - session.createProducer(dest 
ination); 
for (int i = 0; i < 3; i++) ( 
TextMessage message = session.createTextMessage(" X 
家 好 这 是 个 测试 " ) ; 
Thread.sleep(1000); 
// 通过 消息 生产 者 发 出 消息 
producer.send(message); 





session.commit(); 
session.close(); 
connection.close(); 





上 面 的 函数 实现 很 容易 让 我 们 联想 到 数据 库 的 
实现 ， 在 函数 开始 时 需要 一 系列 元 余 的 但 义 必 不 可 
少 的 用 于 连接 的 代码 ， 而 其 中 真正 用 于 及 送 消息 的 








代码 其 实 很 简单 。 
2. Bevin SE 
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上 的 消息 。 





public class Receiver { 
public static void main(String[] args) throws Exception ( 


ConnectionFactory connectionFactory - new ActiveMQ 
ConnectionFactory(); 


Connection connection - connectionFactory.createCo 
nnection(); 
connection.start(); 


final Session session - connection.createSession(B 
oolean. TRUE, Session.AUTO_ ACKNOWLEDGE); 

Destination destination = session.createQueue("my- 
queue"); 


MessageConsumer consumer = session.createConsumer( 
destination); 


int i=0; 
while(i<3) { 
i++; 
TextMessage message = (TextMessage) consumer.r 
eceive(); 
session.commit(); 
//TODO something.... 
System,out,printlLn(" 收 到 消息 : " + message.getTex 
t()); 


J 


session.close(); 
connection.close(); 


j 
p 
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13.2 Spring 4 ActiveMQ 
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建 与 关闭 ，Session 的 创建 与 关闭 等 ， 为 了 消除 这 一 
几 余 工作 量 ，Spring 进 行 了 进一步 的 封装 。Spring 
下 的 ActiveMQ 使 用 方式 如 下 。 


1. Spring 配置 文件 。 


配置 文件 是 Spring 的 核心 ，Spring 整 合 消息 服 
务 的 使 用 也 从 文件 配置 开始 。 类 似 于 数据 库 操作 ， 
Spring 也 将 ActiveMQ 中 的 操作 封装 至 JmsTemplate 
中 ， 以 方便 我 们 统一 使 用 。 所 以 ， 在 Spring 的 核心 
配置 文件 中 首先 要 注册 JmsTemplate 类 型 的 bean。 当 
然 ，ActiveMQConnection Factory 用 于 连接 消 恩 服务 
器 ， 是 消息 服务 的 基础 ， 也 要 注册 。 
ActiveMQQueue 则 用 于 指定 消息 的 目的 地 。 











«beans» 
«bean id="connectionFactory" class="org.apache.activemq.Ac 
tiveMQConnectionFactory"> 
<property name="brokerURL"> 
<value>tcp://localhost :61616</value> 
</property> 


</bean> 


«bean id="jmsTemplate" class="org.Springframework.jms.core 
. JmsTemplate"> 
«property name="CconnectionFactory"> 
<ref bean="connectionFactory" /> 
</property> 
</bean> 


«bean id="destination" class-'org.apache.activemq.command. 
ActiveMQQueue"> 
<constructor-arg index="0"> 
<value>HellowWor ldQueue</value> 
</constructor-arg> 
</bean> 


</beans> 





2. RİR Ü o 


A TUERA, Springin LARJE e Be a 
简化 我 们 的 工作 量 。Spring 中 发 送 消息 到 消息 服务 
255 B 去 了 宛 余 的 Connection 以 及 Session 等 的 创建 
与 销毁 过 程 ， 人 简化 了 工作 量 。 





public class HelloWorldSender { 
public static void main(String args[]) throws Exception { 
ApplicationContext context - new ClassPathXmlApplicati 
onContext ( 


new String[] { "test/activeMQ/Spring/applicati 
onContext.xml" }); 


JmsTemplate jmsTemplate - (JmsTemplate) context.getBea 
n("jmsTemplate"); 

Destination destination - (Destination) context.getBea 
n("destination"); 


jmsTemplate.send(destination, new MessageCreator() { 
public Message createMessage(Session session) thro 
ws JMSException { 
return session.createTextMessage(" 大 家 好 这 个 是 测 


wr. 





3. Paim o 
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public class HelloWorldReciver ( 


public static void main(String args[]) throws Exception { 
ApplicationContext context - new ClassPathXmlApplicati 
onContext( 
new String[] ( "test/activeMQ/Spring/applicati 
onContext.xml" }); 
JmsTemplate jmsTemplate - (JmsTemplate) context.getBea 
n("jmsTemplate"); 
Destination destination (Destination) context.getBea 
n("destination"); 


TextMessage msg - (TextMessage) jmsTemplate.receive(de 
stination); 
System.out.println("reviced msg is:" + msg.getText()); 


l 








到 这 里 我 们 已 经 完 成 了 Spring 消息 的 发送 与 接 
收 操作 。 但 是 ， 如 HelloworldReciver 中 所 示 的 代 
码 ， 使 用 jmsTemplate.receive(destination) 方 法 只 能 
接收 一 次 消 轧 ， 如 采 未 接收 到 消 轧 ， 则 会 一 直 等 
待 。 当 然 用 户 可 以 通过 设置 timeout 属 性 来 控制 等 行 
时 间 ， 但 是 一 旦 接收 到 消息 ， 本 次 接收 任务 残 会 结 
束 ， 虽 然 用 户 可 以 通过 while 人 true) 的 方式 来 实现 循 
环 监听 消息 服务 器 上 的 消 轧 ， 但 是 还 有 一 种 更 好 的 
解决 办 法 一 一 创建 消息 监听 赤 。 消 息 监 听 器 的 使 用 
方式 如 下 。 


1. 创建 消息 监听 器 。 
用 于 监听 消息 ， 一 旦 有 新 消息 ，Spring 就 会 将 


消息 引导 至 消息 监听 器 ， 以 方便 用 户 进行 相 应 的 多 
BERI, 

















public class MyMessageListener implements MessageLlistener( 


QOverride 
public void onMessage(Message arg0) { 
TextMessage msg = (TextMessage) arg0; 
try { 
System.out.println(msg.getText()); 
) catch (JMSException e) ( 
e.printStackTrace(); 





2. 修改 配置 文件 。 


为 了 使 用 消 恩 监听 右 ， 需 要 在 配置 文件 中 注册 
AAS, FORE ET aie A BALA HP o 





<beans> 


«bean id="connectionFactory" class="org.apache.activemq.A 
ctiveMQConnectionFactory"> 
<property name="brokerURL"> 
<value>tcp://localhost :61616</value> 
</property> 


</bean> 


<bean id="jmsTemplate" class="org.Springframework.jms.core 
.JmsTemplate"» 
«property name="CconnectionFactory"> 
«ref bean="connectionFactory" /> 
</property> 
</bean> 


«bean id="destination" class="org.apache.activemq.command. 
ActiveMQQueue"> 
<constructor-arg index="0"> 
<value>HellowWor ldQueue</value> 
</constructor-arg> 
</bean> 


<bean id="myTextListener" class="test.activeMQ.Spring.MyMe 
ssageListener" /> 


<bean id="javaConsumer" 
class="org.Springframework. jms.listener .DefaultMessage 
ListenerContainer"> 
«property name-"connectionFactory" ref="connectionFact 
ory" /» 
«property name="destination" ref="destination" /» 
«property name="messageListener" ref="myTextListener" 
/> 
</bean> 


«/beans» 


XE SE EA ERES CSE AY PAE AT V Hs Ur BS D B 
f. —HHB RS ENTRIB AMA ds, wes BE I. 
ras tn Yr 2], FFE Spring IH RARS S 83H Ah 
Ur RB Ach SB pa CH, SEIH P ERE 2 2h 


13.3 ”源码 分 析 


尽管 消息 接收 可 以 使 用 消息 监听 器 的 方式 符 代 
模板 方法 ， 但 是 在 发 送 阶段 模板 方法 仍然 是 无 法 蔡 
代 的 ， 在 Spring 中 必须 要 使 用 JmsTemplate 提 供 的 方 
法 来 进行 发 送 操作 ， 可 见 JmsTemplate 类 的 重要 
PE, ALA FRAT NTF Spring! Gi SIRS a ar eM 
JmsTemplate7T 4A . 














13.3.1 JmsTemplate 


在 代码 与 Spring 整合 的 实例 中 ， 我 们 看 到 
Spring 采用 了 与 JDBC 等 一 贯 的 套路 ， 为 我 们 提供 了 
JmsTemplate2 5j 2 25 HABE. £A JmsTemplatef] 
类 型 层级 结构 图 ， 如 图 13-1 所 示 。 





«pn E- 
4 K9 JmsTemplate 
4 (9^ ImsDestinationAccessor 
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(9 Object 
© InitializingBean 
€  ImsOperations 


图 13-1 JmsTemplate 的 类 型 层级 结构 图 


首先 还 是 按照 一 吐 的 分 析 套 路 ， 提 取 我 们 感 兴 
趣 的 接口 Tiril aing ea 接口 方法 实现 在 
JmsAccessor 类 中 ， 如 下 : 








public void afterPropertiesSet() { 
if (getConnectionFactory() -- null) ( 
throw new IllegalArgumentException("Property 'conn 
ectionFactory' is required"); 


j 
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首先 以 发 送 为 例 ， 在 Spring 中 发 送 消息 可 以 通过 
JmsTemplate 中 提供 的 方法 来 实现 。 





public void send(final Destination destination, final MessageCr 
eator messageCreator) throws JmsException 


(8 A 77 AH P: 


jmsTemplate.send 


(destination, new MessageCreator() ( 
public Message createMessage(Session session) thro 
ws JMSException ( 
return session.createTextMessage(" 大 家 好 这 个 是 测 





我 们 束 跟 着 程序 流 ， 进 入 函数 send 查 看 其 源 代 
fiU. 


public void send(final Destination destination, final MessageCr 
eator messageCreator) throws JmsException { 
execute 


(new SessionCallback<Object>() { 
public Object doInJms(Session session) throws JMSE 
xception { 
doSend(session, destination, messageCreator); 
return null; 


} 
}, false); 








现在 的 风格 不 得 不 让 我 们 回 想起 JdbcTemplate 

的 类 实现 风格 ， 它 们 极为 相似 ， 都 是 提取 一 个 公共 

的 方法 作为 最 展 层 、 最 通用 的 功能 实现 ， 然 后 又 通 

过 回调 函数 的 不 同 来 区 分 个 性 化 的 功能 ， RATE E 
得 看 通用 代码 的 抽取 实现 。 





通用 代码 抽取 


根据 之 前 分 析 J dbcTemplate 的 经 验 ， 我 们 推 
Wt, execute F — E 7239 48 [ Connection UJ 
Session 的 创建 操作 。 





public «T» T execute(SessionCallback«T» action, boolean startCo 
nnection) throws JmsException { 
Assert.notNull(action, "Callback object must not be nu 


11"); 
Connection conToClose = null; 
Session sessionToClose = null; 
try { 
Session sessionToUse = ConnectionFactoryUtils.doGe 
tTransactionalSession( 
getConnectionFactory(), this.transactional 
ResourceFactory, 
startConnection) ; 
if (sessionToUse == null) { 
// 创 建 connection 
conToClose = createConnection(); 
// 根 据 connection 创 建 session 
sessionToClose = d e 


// 是 否 开启 向 服务 器 推送 连接 信息 ， 只 有 接收 信息 时 需要 ， 发 


























送 时 不 需 


4 
R8 


if (startConnection) { 
conToClose.start(); 


j 


sessionToUse - sessionToClose; 


} 
if (logger.isDebugEnabled()) { 
logger.debug("Executing callback on JMS Sessio 
n: " + sessionToUse); 


} 
// 调 用 回调 函数 
return action.doInJms(sessionToUse); 


} 
catch (JMSException ex) { 


throw convertJmsAccessException(ex); 


} 


finally { 
// 关 闭 session 
JmsUtils.closeSession(sessionToClose); 
/ REOR TE 
ConnectionFactoryUtils.releaseConnection(conToClos 
e, getConnectionFactory(), startConnection); 





j 





在 单独 使 用 activeMQ 时 ， 我 们 知道 为 了 发 送 一 
条 消 奶 需要 做 很 多 工作 ， 它 需要 很 多 的 辅助 代码 ， 
而 这 些 代 人 码 又 都 是 干 篇 一 律 的 ， 没 有 任何 的 差异 ， 
所 以 execute 方 法 的 目的 就 是 帮助 我 们 抽 离 这 些 见 余 
代码 ， 从 而 使 我 们 更 加 专注 于 业务 逻辑 的 实现 。 从 
负数 中 看 ， 这 些 元 余 代 码 包 括 创 建 Connection、 创 
建 Session， 当 然 也 包括 关闭 Session 和 关闭 
Connection。 而 在 准备 工作 结束 后 ， 将 调用 回调 也 
数 将 程序 引入 用 户 目 定义 实现 的 个 性 化 处 理 。 至 于 
如 何 创建 Session 与 Connection， 有 兴趣 的 读者 可 以 
进一步 研究 Spring 的 源码 。 
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有 了 基 类 辅助 的 实现 ， 使 得 Spring 更 加 专注 于 
AS VER ADEE, th LAE Ub Spring (# H execute 77 yesh $e 
了 元 余 代 人 码 ， 而 将 个 性 化 的 代码 实现 放 在 了 回调 函 
数 doInJms 函 数 中 。 在 发 送 消 恩 的 功能 中 通过 局 部 
类 实现 回调 函数 。 








new SessionCallback<Object>() { 
public Object doInJms(Session session) throws JMSE 


xception { 
doSend 


(session, destination, messageCreator); 
return null; 


j 





此 时 的 发 送 馆 辑 已 经 完 全 航 转 癌 了 doSend 方 
法 ， 这 样 使 整个 功能 实现 变 得 更 加 清晰 。 





protected void doSend(Session session, Destination destination, 
MessageCreator 
messageCreator ) 
throws JMSException { 


Assert.notNull(messageCreator, "MessageCreator must no 
t be null"); 
MessageProducer producer = createProducer(session, des 
tination); 
try { 
Message message - messageCreator.createMessage(ses 


sion); 
if (logger.isDebugEnabled()) (1 
logger.debug("Sending created message: " + mes 
sage); 
} 
doSend 


(producer, message); 
// Check commit - avoid commit call within a JTA t 
ransaction. 
if (session.getTransacted() && isSessionLocallyTra 
nsacted(session)) { 
// Transacted session created by this template 
-» commit. 
JmsUtils.commitlIfNecessary(session); 


} 
finally { 
JmsUtils.closeMessageProducer(producer); 


j 


protected void doSend(MessageProducer producer, Message message 
) throws JMSException { 
if (isExplicitQosEnabled()) { 
producer.send(message, getDeliveryMode(), getPrior 
ity(), getTimeToLive()); 
} 


else ( 
producer.send(message); 








在 演示 独立 使 用 消 明 功能 的 时 候 ， 我 们 大 体 了 





解 了 消息 发 送 的 基本 套路 ， 虽 然 这 些 步骤 已 经 入 
Spring 拆 得 文 离 人 破碎 ， 但 是 我 们 还 是 能 捕捉 到 一 些 
影子 。 发 送 消 恩 时 还 是 齐 循 着 消息 发 送 的 规则 ， 比 
如 根据 Destination 创 建 MessageProducer、Message， 
并 使 用 MessageProducer 实 例 来 发 送 消息 。 
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我 们 通常 使 用 jmsTemplate.receive(destination) 
来 接收 简单 的 消息 ， 那 么 Spring 是 如 何 封装 这 个 功 
能 的 呢 ? 





public Message receive(Destination destination) throws JmsExcep 
tion ( 
return receiveSelected 


(destination, null); 


j 


public Message receiveSelected(final Destination destination, f 
inal String messageSelector) 
throws JmsException { 
return execute(new SessionCallback<Message>() { 
public Message doInJms(Session session) throws JMS 
Exception ( 
return doReceive 


(session, destination, messageSelector); 


} 
}, true); 


j 


protected Message doReceive(Session session, Destination destin 
ation, String messageSelector) 
throws JMSException { 


return doReceive(session, createConsumer(session, dest 
ination, messageSelector)); 


j 


protected Message doReceive(Session session, MessageConsumer co 
nsumer) throws JMSException { 
try { 
// Use transaction timeout (if available). 
long timeout - getReceiveTimeout(); 
JmsResourceHolder resourceHolder - 
(JmsResourceHolder) TransactionSynchroniza 
tionManager.getResource (getConnectionFactory()); 
if (resourceHolder !- null && resourceHolder.hasTi 
meout()) { 
timeout - Math.min(timeout, resourceHolder.get 
TimeToLiveInMillis()); 
} 


Message message = doReceive 


(consumer, timeout); 
if (session.getTransacted()) { 
// Commit necessary - but avoid commit call wi 
thin a JTA transaction. 
if (isSessionLocallyTransacted(session)) ( 


// Transacted session created by this temp 
late -» commit. 
JmsUtils.commitlIfNecessary(session); 


j 


else if (isClientAcknowledge(session)) ( 
// Manually acknowledge message, if any. 
if (message !- null) ( 
message.acknowledge(); 


} 
} 
return message; 
} 
finally { 
JmsUtils.closeMessageConsumer (consumer); 
} 


j 


private Message doReceive(MessageConsumer consumer, long timeou 
t) throws JMSException ( 


if (timeout -- RECEIVE TIMEOUT NO WAIT) ( 
return consumer.receiveNoWait(); 


else if (timeout > 0) ( 
return consumer.receive(timeout); 


else { 
return consumer.receive(); 


j 





实现 的 套路 与 发 送 兰 不 多 ， 同 样 还 是 使 用 





execute 国 数 来 封装 元 余 的 公共 操作 ， 而 最 终 的 目标 
还 是 通过 consumer.receive() 来 接收 消息 ， 其 中 的 过 
程 就 是 对 于 MessageConsumer 的 创建 以 及 一 些 辅助 


13.3.2 ”监听 器 容器 


消息 监听 器 容器 是 一 个 用 于 碍 看 JMS 目 标 等 待 
消息 到 达 的 特殊 bean， 一 旦 消息 到 达 它 束 可 以 获取 
到 消息 ， 并 通过 调用 onMessage() 方 法 将 消息 传递 给 
一 个 MessageListener 实 现 。Spring 中 消息 监听 器 容 
ar HJ2S 7 UI P. 





e SimpleMessageListenerContainer: 最 简单 的 消息 
监听 痪 容器 ， 只 能 处 理 固定 数量 的 JMS 会 话 ， 且 
不 文 持 事 务 。 

e DefaultMessageListenerContainer: 这 个 消息 监听 
Ax fas 1E V. TE SimpleMessageListener Container? 
器 之 上 ， 添 加 了 对 事务 的 文 持 。 

e serversession.ServerSessionMessage.ListenerContai 
XX Xe He foco KHU E e darme. Lm 
DefaultMessageListenerContainerfH[r], KE f 3c F# 
事务 ， 它 还 允许 动态 地 管理 JMS 会 话 。 








下 面 以 DefaultMessageListenerContainer 为 例 进 
行 分 林 ， 了 解 消息 监听 器 容器 的 实现 。 在 之 前 消息 
监听 需 的 使 用 示例 中 ， 我 们 了 解 到 在 使 用 消 妃 监听 
fit Eas] — XE TEL XE LIRE TS A hs ra AB AS n 
FH, 3XURÉTERARAP AT AEC Ba AED, TUB PB) 
Wr as Abst. 44 DefaultMessageListenerContainer}= 





次 结构 图 ， 如 图 13-2 所 示 。 
*Bpn & - 


4 X9 DefaultMessageListenerContainer 
4 (9^ AbstractPollingMessageListenerContainer 
4 (9^ AbstractMessagelistenerContainer 
4 (9^ AbstractimsListeningContainer 
4 (9^ ImsDestinationAccessor 
4 (9^ ImsAccessor 
(9 Object 
@ InitializingBean 
4 @ BeanNameAware 
Q Aware 
© DisposableBean 
4 €) SmartLifecycle 
Q Lifecycle 
@ Phased 
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同样 ， 我 们 看 到 此 类 实现 了 InitializingBean 接 
口 ， 按 照 以 往 的 风格 我 们 还 是 首先 得 看 接口 方法 
afterPropertiesSet() 中 的 逻辑 ， 其 方法 实现 在 其 父 类 
AbstractJmsListeningContainer 中 。 





public void afterPropertiesSet() ( 
// 验 证 connectionFactory 
super.afterPropertiesSet(); 
// 验 证 配置 文件 





validateConfiguration(); 
// 初 始 化 
initialize(); 
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前 两 句 只 用 于 属性 的 验证 ， 比 如 connectionFacory 或 
者 destination 等 属性 是 否 为 空 等 ， 而 真正 用 于 初始 
化 的 操作 委托 在 initialize0 中 执行 。 


public void initialize() throws JmsException { 
try { 
//1LifecycleMonitor 用 于 控制 生命 周期 的 同步 处 理 
synchronized (this.lifecycleMonitor) { 
this.active - true; 
this.lifecycleMonitor.notifyAll(); 



































doInitialize 


catch (JMSException ex) { 
synchronized (this.sharedConnectionMonitor) { 
ConnectionFactoryUtils.releaseConnection(this. 
sharedConnection, 
getConnectionFactory(), this.autoStartup); 
this.sharedConnection - null; 


j 


throw convertJmsAccessException(ex); 


j 


protected void doInitialize() throws JMSException { 
synchronized (this.lifecycleMonitor) { 
for (int 1 = 0; i < this.concurrentConsumers 


scheduleNewInvoker 





这 里 用 到 了 concurrentConsumers 属 性 ， 了 网络 中 
对 此 属性 用 法 的 说 明 如 下 。 


消息 监听 需 人 允许 创建 多 个 Session 和 
MessageConsumer 来 接收 消息 。 有 具体 的 个 数 由 
concurrentConsumers 属 性 指定 。 需 要 注意 的 是 ， 应 
该 只 是 在 Destination 为 Queue 的 时 候 才 使 用 多 个 
MessageConsumer (Queue 中 的 一 个 消息 只 能 被 一 个 
Consumer 接 收 ) ， 虽 然 使 用 多 个 MessageConsumer 
会 提高 消息 处 理 的 性 能 ， 但 是 消息 处 理 的 顺序 却 得 
不 到 保证 。 消 奶 被 接收 的 顺序 仍然 是 消 姑 发送 时 的 
顺序 ， 但 是 由 于 消息 可 能 会 被 并 发 处 理 ， 因 此 消息 
处 理 的 顺序 可 能 和 消息 发 送 的 顺序 不 同 。 此 外 ， 不 
应 该 在 Destination 为 Topic 的 时 候 使 用 多 个 
MessageConsumer， 因 为 多 个 MessageConsumer 会 接 
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private void scheduleNewInvoker() { 


AsyncMessageListenerInvoker invoker = new AsyncMessage 
ListenerInvoker 


(0; 


if (rescheduleTaskIfNecessary 


(invoker)) { 
// This should always be true, since we're only calling this wh 
en active. 

this.scheduledInvokers.add(invoker); 


j 


J 


protected final boolean rescheduleTaskIifNecessary(Object task) 
{ 


if (this.running) { 


try { 
doRescheduleTask 
(task); 
catch (RuntimeException ex) { 
logRejectedTask(task, ex); 
this.pausedTasks.add(task) ; 
return true; 
} 
else if (this.active) { 
this.pausedTasks.add(task); 
return true; 
} 
else ( 
return false; 
} 
} 


protected void doRescheduleTask(Object task) { 
this.taskExecutor.execute((Runnable) task); 
} 





分 析 源 码 得 知 ， 根 据 concurrentConsumers 数 量 
建立 了 对 应 数量 的 线程 ， 即 使 读者 不 了 解 线 程 池 的 
使 用 ， 根 据 以 上 代码 至 少 可 以 推断 出 





doRescheduleTask 隙 数 其 实 是 在 开启 一 个 线程 执行 
Runnable。 我 们 反 退 踪 这 个 传 入 的 参数 ， 可 以 看 到 
它 其 实 是 AsyncMessageListenerInvoker 类 型 实例 。 


Ale 1] DAE, SpringfR d 











concurrentConsumers 数 量 建立 了 对 应 数量 的 线程 ， 
而 每 个 线程 都 作为 一 个 独立 的 接收 者 在 循环 接收 消 
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于 是 我 们 把 所 有 的 焦点 转 问 
AsyncMessageListenerInvoker 这 个 类 的 实现 ， 因 为 
它 作 为 一 个 Runnable 角 色 去 执行 ， 所 以 对 这 个 类 的 
分 析 从 run 方 法 开始 。 








public void run() { 
// 并 发 控制 
synchronized (lifecycleMonitor) { 
activeInvokerCount++; 
lifecycleMonitor.notifyAll(); 





boolean messageReceived - false; 
try { 
// 根 据 每 个 任务 设置 的 最 大 处 理 消 息 数量 而 作 不 同 处 理 
// 小 于 0 默认 为 无 限制 ， 一 直接 收 消息 
if (maxMessagesPerTask < 0) { 
messageReceived = executeOngoingLoop 


















































else ( 
int messageCount - 0; 
// 消 息 数 量 控制 ， 一 旦 超出 数量 则 停止 循环 


while (isRunning() && messageCount < maxMe 














ssagesPerTask) ( 
messageReceived = (invokeListener 


() || messageReceived); 


j 


messageCount--; 


} 

} 

catch (Throwable ex) { 
// 清 理 操作 ， 包 括 关 闭 session 等 
clearResources(); 




















if (!this.lastMessageSucceeded) { 
// We failed more than once in a row - sle 
ep for recovery interval 


// even before first recovery attempt. 
sleepInbetweenRecoveryAttempts(); 
} 
this.lastMessageSucceeded = false; 
boolean alreadyRecovered - false; 
synchronized (recoveryMonitor) ( 
if (this.lastRecoveryMarker -- currentReco 
veryMarker) ( 
handleListenerSetupFailure(ex, false); 
recoverAfterListenerSetupFailure(); 
currentRecoveryMarker - new Object(); 


else ( 
alreadyRecovered - true; 


j 


if (alreadyRecovered) { 
handleListenerSetupFailure(ex, true); 


j 


} 
finally { 
synchronized (lifecycleMonitor) { 
decreaseActiveInvokerCount(); 
lifecycleMonitor.notifyAll(); 


if (!messageReceived) { 
this.idleTaskExecutionCount++; 


else { 
this.idleTaskExecutionCount = 0; 
} 
synchronized (lifecycleMonitor) { 
if (!shouldRescheduleInvoker(this.idleTask 
ExecutionCount) || 
!reschedule TaskIfNecessary(this)) { 
// We're shutting down completely. 
scheduledInvokers.remove(this); 
if (logger.isDebugEnabled()) { 
logger.debug("Lowered scheduled in 
voker count: " + 
scheduledInvokers.size()); 


} 
lifecycleMonitor.notifyAll(); 
clearResources(); 


else if (isRunning()) { 
int nonPausedConsumers - getScheduledC 
onsumerCount() - 
getPausedTaskCount( ); 
if (nonPausedConsumers « 1) ( 
logger.error("All scheduled consum 
ers have been paused, 
probably due to tasks having been rejected. " + 
"Check your thread pool co 
nfiguration! Manual 
recovery necessary through a start() call."); 


else if (nonPausedConsumers « getConcu 
rrentConsumers()) { 
logger.warn("Number of scheduled c 
onsumers has dropped 
below concurrentConsumers limit, probably " + 
"due to tasks having been 
rejected. Check your 
thread pool configuration! Automatic recovery " + 
"to be triggered by remain 
ing consumers."); 








以 上 函数 主要 根据 变量 maxMessagesPerTask 的 








值 来 分 情况 处 理 ， 当 然 ， 函 数 中 还 使 用 了 大 量 的 代 
码 处 理 异 第 机 制 的 数据 维护 ， 但 是 我 相信 大 家 跟 我 
一 样 更 加 关注 程序 的 正常 流程 是 如 何 处 理 的 。 


其 实 核 心 的 处 理 束 是 调用 invokeListener 来 接收 
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下 ， 用 户 可 以 通过 设置 标志 位 running 来 控制 消息 接 
收 的 暂停 与 恢复 ， 并 维护 当前 消 明 监听 右 的 数量 。 


private boolean executeOngoingLoop() throws JMSException { 
boolean messageReceived - false; 
boolean active - true; 
while (active) { 
synchronized (lifecycleMonitor) { 

boolean interrupted = false; 

boolean wasWaiting = false; 

// 如 果 当 前 任务 已 经 处 于 激活 状态 但 是 却 给 了 和 暂时 终止 的 











命令 
while ((active = isActive()) && !isRunning 
0) t 
if (interrupted) { 
throw new IllegalStateException("T 
hread was interrupted 
while waiting for " + 
"a restart of the listener 
container, but container is still stopped"); 
} 
if (!wasWaiting) { 
// 如 果 并 非 处 于 等 待 状态 则 说 明 是 第 一 次 执行 





， 需 要 将 激活 任务 数量 减少 





decreaseActiveInvokerCount(); 


} 
// 开 始 进入 等 待 状态 ， 等 待 任务 的 恢复 命令 
wasWaiting = true; 
try { 
// 通 过 wait 等 待 ， 也 就 是 等 待 notify 或 者 no 





tifyAll 
lifecycleMonitor.wait(); 


catch (InterruptedException ex) { 
// Re-interrupt current thread, to 
allow other threads to react. 
Thread.currentThread().interrupt() 


interrupted - true; 


j 


} 
if (wasWaiting) { 
activeInvokerCount++; 


if (scheduledInvokers.size() > maxConcurre 
ntConsumers) { 


active = false; 


j 


} 
// 正 常 处 理 流程 
if (active) { 
messageReceived = (invokeListener() || mes 























sageReceived); 


j 


return messageReceived; 
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中 的 ， 而 是 直接 进入 函数 invokeListener() 来 接收 消 
息 并 激活 监听 器 ， 但 是 ， 不 可 能 让 循环 一 直 持 续 下 





去 ， 我 们 要 考虑 到 暂停 线程 或 者 恢复 线程 的 情况 ， 
MAY, isRunningOPK Z4 LUKE FH25 T -o 


isRunningO 用 来 检测 标志 位 this.running 状 态 进 
而 判断 是 否 希 要 进入 while 和 循环。 由 于 要 维护 当前 线 
程 激活 数量 ， 所 以 引入 了 wasWaiting 变 量 ， 用 来 判 
上 晰 线程 是 否 处 于 等 竺 状态。 如果 线程 首次 进入 等 竺 
状态 ， 则 需要 减少 线程 来 激活 数量 计数 堪 。 


当然 ， 偿 有 一 个 地 方 需要 提 一 下 ， 台 是 线程 等 
符 不 是 一 味 地 采用 while 循 环 来 控制 ， 因 为 如 朱 单 纯 








地 采用 while 循 环 会 浪费 CPU 的 时 钟 周期 ， 给 资源 造 
成 巨大 的 浪费 。 这 里 ，Spring 采 用 全 局 控制 变量 
lifecycleMonitor 的 waitO 方 法 来 暂停 线程 ， 所 以 ， 如 
末 终 止 线程 需要 再 次 恢复 的 话 ， 除 了 更 改 
this.running 标 志 位 外 ， 还 需要 调用 
lifecycleMonitor.notify 或 者 lifecycle Monitor.notifyAll 
来 使 线程 恢复 。 
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private boolean invokeListener() throws JMSException { 
// 初 始 化 资源 包括 首次 创建 的 时 候 创 建 session 与 consumer 
initResourcesIfNecessary(); 
boolean messageReceived - receiveAndExecute 








(this, this.session, this.consumer); 
// 改 变 标志 位 ， 信 息 成 功 处 理 
this.lastMessageSucceeded = true; 
return messageReceived; 























protected boolean receiveAndExecute(Object invoker, Session ses 
sion, MessageConsumer consumer ) 
throws JMSException { 


if (this.transactionManager !- null) { 
// Execute receive within transaction. 
TransactionStatus status - this.transactionManager 
.getTransaction(this. 
transactionDefinition); 
boolean messageReceived; 


try { 
messageReceived - doReceiveAndExecute 


(invoker, session, consumer, status); 
} 
catch (JMSException ex) { 


rollbackOnException(status, ex); 
throw ex; 


catch (RuntimeException ex) { 
rollbackOnException(status, ex); 
throw ex; 


catch (Error err) { 
rollbackOnException(status, err); 
throw err; 

} 

this.transactionManager.commit(status); 

return messageReceived; 


j 


else ( 
// Execute receive outside of transaction. 
return doReceiveAndExecute 


(invoker, session, consumer, null); 


j 
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立 在 SimpleMessageListenerContainer 容 器 之 上 ， 它 
添加 了 对 事务 的 文 持 ， 那 么 此 时 ， 事 务 特性 的 实现 
束 开 始 了 。 如 果 用 户 配 置 了 





this.transactionManager， 也 束 是 配置 了 事务 ， 那 
么 ， 消 息 的 接收 会 被 控制 在 事务 之 内 ， 一 旦 出 现任 
何 异 常 都 会 补 回 深 ， 而 回 深 操 作 也 会 交 由 事务 管理 
器 统一 处 理 ， 比 如 


this.transactionManager.rollback(status) . 








doReceiveAndExecute 包 含 了 整个 消息 的 接收 处 


理 过 程 ， 由 于 摊 杂 看 事务 ， 所 以 并 没有 复 用 模板 中 
的 方法 。 





protected boolean doReceiveAndExecute( 

Object invoker, Session session, MessageConsumer c 
onsumer,TransactionStatus status) 

throws JMSException { 


Connection conToClose - null; 
Session sessionToClose - null; 
MessageConsumer consumerToClose - null; 
try { 
Session sessionToUse - session; 
boolean transactional - false; 
if (sessionToUse == null) { 
sessionToUse = ConnectionFactoryUtils.doGetTra 
nsactionalSession( 
getConnectionFactory(), this.transacti 
onalResourceFactory, true); 
transactional - (sessionToUse !- null); 
} 
if (sessionToUse -- null) { 
Connection conToUse; 
if (sharedConnectionEnabled()) { 
conToUse - getSharedConnection(); 
} 
else ( 
conToUse - createConnection(); 
conToClose - conToUse; 
conToUse.start(); 
} 
sessionToUse = createSession(conToUse); 
sessionToClose = sessionToUse; 
} 
MessageConsumer consumerToUse = consumer; 
if (consumerToUse == null) { 
consumerToUse = createListenerConsumer (session 
ToUse); 
consumerToClose - consumerToUse; 


J 
// 接 收 消息 


Message message = receiveMessage 


(consumerToUse); 
if (message !- null) ( 
if (logger.isDebugEnabled()) { 
logger .debug( "Received message of type [" 

+ message.getClass() + "] from consumer [" + 

consumerToUse + "] of " + (transac 
tional ? "transactional " : "") + "session [" + 

sessionToUse + "]"); 


} 
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messageReceived(invoker, sessionToUse); 
boolean exposeResource - (!transactional && is 
ExposeListenerSession() && 
!TransactionSynchronizationManager .has 
Resource (getConnection 
Factory())); 
if (exposeResource) ( 
TransactionSynchronizationManager.bindReso 
urce( 
getConnectionFactory(), new Locall 
yExposedJms Resource 
Holder(sessionToUse)); 


try { 
// 激 活 监听 器 


doExecuteListener 


(sessionToUse, message); 
} 
catch (Throwable ex) { 
if (status != null) { 
if (logger.isDebugEnabled()) { 
logger.debug("Rolling back transac 
tion because of listener exception thrown: " + ex); 


} 
status.setRollbackOnly(); 


} 
handleListenerException(ex); 
// Rethrow JMSException to indicate an inf 
rastructure problem 
// that may have to trigger recovery... 
if (ex instanceof JMSException) { 
throw (JMSException) ex; 


j 


} 
finally { 
if (exposeResource) { 
TransactionSynchronizationManager.unbi 
ndResource 
(getConnectionFactory()); 
} 
} 


// Indicate that a message has been received. 
return true; 
} 
else ( 
if (logger.isTraceEnabled()) { 
logger.trace("Consumer [" + consumerToUse 
+ "] of " + (transactional ? "transactional " : "") + 
"session [" + sessionToUse + "] di 
d not receive a message"); 




















} 
// 接 收 到 空 消息 的 处 理 
noMessageReceived(invoker, sessionToUse); 
// Nevertheless call commit, in order to reset 
the transaction timeout 
(if any). 





// However, don't do this on Tibco since this 
may lead to a deadlock there. 
if (shouldCommitAfterNoMessageReceived(session 


ToUse)) ( 
commitlIfNecessary(sessionToUse, message); 
} 
// Indicate that no message has been received. 
return false; 
} 
} 
finally { 


JmsUtils.closeMessageConsumer (consumerToClose) ; 

JmsUtils.closeSession(sessionToClose); 

ConnectionFactoryUtils.releaseConnection(conToClos 
e, getConnectionFactory(), true); 


j 


j 





上 面 函数 代码 看 似 索 杂 ， 但 是 真正 的 逻辑 并 不 
多 ， 大 多 是 固定 的 套路 ， 而 我 们 最 关心 的 问题 就 是 
监听 堪 的 激活 处 理 。 





protected void doExecuteListener(Session session, Message messa 
ge) throws JMSException { 
if (!isAcceptMessagesWhileStopping() && !isRunning()) 


{ 
if (logger.iswarnEnabled()) { 


logger.warn("Rejecting received message becaus 
e of the listener 
container " + 
"having been stopped in the meantime: 
" * message); 


rollbackIfNecessary(session); 
throw new MessageRejectedWhileStoppingException(); 
} 


try { 
invokeListener 


(session, message); 


catch (JMSException ex) { 
rollbackOnExceptionIfNecessary(session, ex); 
throw ex; 


catch (RuntimeException ex) { 
rollbackOnExceptionIfNecessary(session, ex); 
throw ex; 


catch (Error err) { 
rollbackOnExceptionIfNecessary(session, err); 
throw err; 


commitIfNecessary 


(session, message); 


j 


protected void invokeListener(Session session, Message message) 
throws JMSException { 


Object listener = getMessageListener(); 
if (listener instanceof SessionAwareMessageListener) { 
doInvokeListener 


((SessionAwareMessageListener) listener, session, message); 


else if (listener instanceof MessageListener) { 
doInvokeListener((MessageListener) listener, messa 


ge); 
else if (listener != null) { 
throw new IllegalArgumentException( 
"Only MessageListener and SessionAwareMess 
ageListener supported: " + listener); 


else { 
throw new IllegalStateException("No message listen 
er specified - see property 'messageListener'"); 


} 
protected void doInvokeListener(MessageListener listener, Messa 
ge message) throws 
JMSException ( 
listener.onMessage(message); 
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listener.onMessage(message) x} Feit 47 SA, tht 
是 激活 了 用 户 自 定义 的 监听 器 人 逻辑 。 这 里 还 有 一 句 
重要 的 代码 很 容易 被 忽略 掉 ， 那 残 是 
commitIfNecessary(session, message)， 它 完成 的 功能 
是 session.commit()。 完 成 消 居 服务 的 事务 提交 ， 涉 
及 两 个 事务 ， 我 们 第 说 的 
DefaultMessageListenerContainer 增 加 了 事务 的 文 
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中 如 果 产 生 其 他 操作 ， 比 如 向 数据 库 中 插入 数据 ， 
一 旦 出 现 异 和 常 时 就 需要 全 部 回 深 ， 包 括 回 深 插 入 数 
据 库 中 的 数据 。 但 是 ， 除 了 我 们 第 说 的 事务 之 外 ， 
对 于 消息 本 身 还 有 一 个 事务 ， 当 接收 一 个 消 妃 的 时 
候 ， 必 须 使 用 事务 提交 的 方式 ， 这 是 在 告诉 消息 服 
Fae AW OA IER RMAC, HARA ae UPA 
地 的 事务 提交 后 便 可 以 将 此 消息 删除 ， 人 否则 ， 当 前 
消 妃 会 被 其 他 接收 者 重新 接收 。 
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"B14* Spring Boot 体 系 原 理 


Spring Boot 是 由 Pivotal 团 队 提 供 的 全 新 框架 ， 
其 设计 目的 是 用 来 简化 新 Spring 应 用 的 初始 搭建 以 
及 开发 过 程 。 该 框 染 使 用 了 特定 的 方式 来 进行 配 
置 ， 从 而 使 开发 人 员 不 再 需要 定义 样板 化 的 配置 。 
通过 这 种 方式 ，Spring Booth} $1 7J FIER KEN 
快速 应 用 开发 领域 CRapid Application 
Development) 成 为 领导 者 。 

















Spring Boot 特 点 如 下 : 


e 创建 独立 的 Spring 应 用 程序 ; 

fAHTomcat, HAR wWAR SC; 

傈 化 Maven 配 置 ; 

目 动 配置 Spring; 

提供 生产 束 绪 型 功能 ， 如 指标 、 健 康 检查 和 外 
部 配置 ， 

。 绝 对 没有 代码 生成 ， 以 及 对 XML 没有 配置 要 


当然 ， 这 样 的 介绍 似乎 太 过 于 官方 化 ， 好 像 并 
没有 帮助 我 们 理解 Spring Boot 到 底 做 了 什么 ， 我 们 


不 妨 通过 一 个 小 例子 来 快速 了 解 Spring Boot. 
首先 我 们 搭建 一 个 maven 工 程 ，pom 如 下 : 


<?xml version="1.0" encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 

http://maven.apache.org/xsd/maven-4.0.0.xsd"» 


«parent» 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-parent</artifactId> 
<version>2.0.1.RELEASE</version> 
<relativePath/> 

</parent> 


<modelVersion>4.0.0</modelVersion> 
«groupId»com.springstudy«c/groupId» 
<artifactId>study-web</artifactId> 
<version>1.0-SNAPSHOT</version> 


<dependencies> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
</dependency> 
</dependencies> 


<build> 
<plugins> 
<plugin> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-maven-plugin</artifactI 


</plugin> 
</plugins> 
</build> 


</project> 





然后 我 们 建立 一 个 controller 类 : 


package com.springstudy.controller; 

import com.spring.study.module.HelloService; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 


QRestController 
public class TestController ( 
QRequestMapping("/") 
String home() ( 
return "helloworld"; 


} 





最 后 我 们 再 加 入 局 动 整个 项 目的 main 函 数 : 


package com.springstudy; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplica 
tion; 


@SpringBootApplication 
public class SpringBootDemoiApplication { 
public static void main(String[] args) { 
SpringApplication 


.run(SpringBootDemoiApplication.class, args); 


j 








以 上 就 是 我 们 要 准备 的 示例 的 所 有 内 容 ， 最 后 
我 们 尝试 启动 main 函 数 并 在 浏览 器 中 输入 localhost 





:8080， 友 现 浏 览 嚣 显示 如 图 14-1 所 示 的 界面 。 


© © € | & localhost:8080 
< C © localhost:8080 


helloworld 


图 14-1 第 一 个 Spring Boot 


这 一 切 都 似乎 完全 超 卑 了 我 们 的 预料 ， 按 照 之 
前 的 经 验 ， 如 果 要 构建 这 样 一 套 MVC 体 系 ， 似 乎 是 
非常 厂 烦 的 ， 至 少 要 引入 一 大 堆 的 pom 依 赖 ， 同 
时 ， 最 为 神奇 的 是 整个 过 程 中 我 们 似乎 根本 没有 启 
动 过 Tomcat， 但 是 当 我 们 运行 图 数 的 时 候 Tomcat 后 
然 日 动 起 来 了 了， 而 且 还 能 通过 浏览 器 访问 ， 这 一 切 
都 是 怎么 回 事 呢 ? 这 里 留 下 基 念 ， 我 们 稍 后 探索 。 


当然 ， 如 果 你 认为 Spring Boot 仅 仅 是 封装 了 
Tomcat 那 就 大 错 特 错 了 ， 一 个 流行 的 框架 一 定 是 一 
个 理念 的 创新 ， 它 绝对 不 是 一 个 简 简 单单 的 封装 吏 
能 摘 的 定 的 。 


在 我 们 正式 进入 Spring Boot 的 原理 探索 之 前 ， 
自 先 我 们 还 是 笑 试 去 下 载 及 安装 其 源码 。 





14.1 Spring Boot 源 码 安 装 


同样 ，Spring Boot 通 过 Github 维 护 ， 我 们 打开 
Github 官 网 ， 输 入 spring-boot， 如 图 14-2 所 示 。 


Built for 
developers 


GitHul 
| " 





14-2 ”Github 上 搜索 spring-boot 


之 后 的 源码 下 载 (界面 见 图 14-3) 和 安装 的 流 
程 与 第 1 章 中 介绍 的 Spring 源码 下 载 和 安装 流程 相 
Fj, Ex HOLT BERG. 


| Spring Boot 
Spring Boot is a coding and configuration model for Java applications. 


See topic 


68,104 repository results Sort: Best match ~ 
spring-projects/spring-boot @ Java * 23.8k 


Spring Boot 


图 14-3 ”Github 上 搜索 Spring Boot 
14.2 ”第 一 个 Starter 


在 我 看 来 ，Spring Boot 之 所 以 流行 ， 是 因为 
spring starter 模 式 的 提出 。spring starter 的 出 现 ， 可 
以 让 模块 开发 更 加 独立 化 ， 相 互 间 依赖 更 加 松散 以 
及 可 以 更 加 方便 地 集成 。 从 前 言 中 介绍 的 例子 来 
看 ， 正 是 由 于 在 pom 文 件 中 引入 了 下 述 代码 : 








«dependency» 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-starter-web</artifactId> 


</dependency> 





xx WELES pring H IHRE RA SSE i HY SF 
情 ， 当 然 现 阶段 我 们 去 分 析 spring-boot- starter-web 


的 实现 原理 似乎 跨越 还 有 些 大 ， 我 们 可 以 从 一 个 更 
为 简单 的 例子 来 看 。 


同样 ， 为 了 不 跟 之 前 的 Web 工程 混 消 ， 我 们 另 
于 一 个 maven 工 程 ，pom 如 下 : 





<?xml version="1.0" encoding="UTF-8"?> 

<project xmlns="http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0rg/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 

http://maven.apache.org/xsd/maven-4.0.0.xsd"» 


<modelVersion>4.0.0</modelVersion> 
«groupId»com.springstudy«c/groupId» 
<artifactId>study-client-starter 


</artifactId> 
<version>1.0-SNAPSHOT</version> 
<dependencies> 
<dependency> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot -autoconfigure</artifactId> 
</dependency> 
</dependencies> 
<dependencyManagement> 
<dependencies> 
<dependency> 
<!-- Import dependency management from Spring B 
oot --> 
«groupId»org.springframework.boot«/groupId» 
<artifactId>spring-boot-dependencies</artifactI 
d> 
<version>2.0.1.RELEASE</version> 
<type>pom</type> 
<scope>import</scope> 
</dependency> 
</dependencies> 
</dependencyManagement> 
</project> 











然后 我 们 定义 一 个 接口 ， 可 以 认为 它 是 当前 独 
并 业务 开 友 模块 对 外 其 露 的 可 以 直接 调用 的 接口 ， 
如 下 : 


package com.spring.study.module; 
public interface HelloService { 
public String sayHello(); 


j 





我 们 对 这 个 接口 做 一 个 简单 的 实现 ， 返 回 hello 
字符 串 : 


package com.spring.study.module; 
import org.springframework.stereotype.Component; 


QComponent 
public class HelloServicelmpl implements HelloService { 
public String sayHello()( 


return "hello!! ": 








以 上 实现 为 了 尽量 屏 贡 Spring Boot 基 础 理论 以 
外 的 东西 ， 把 汗 示 设计 得 尽量 简单 ， 如 果 是 真实 的 
业务 ， 这 个 接口 以 及 接口 实现 可 能 会 非常 复杂 ， 甚 
至 还 会 间接 依赖 于 非常 多 的 其 他 的 bean。 它 基本 上 
残 是 一 个 独立 的 业务 模块 ， 当 然 这 个 模块 并 不 是 目 

己 部 普 ， 而 是 运行 在 依赖 它 的 主 函 数 中 。 如 朱 我 们 

















开发 到 这 种 程度 ， 想 要 主 函 数 感 知 的 话 也 不 是 不 可 
以 ， 但 是 至 少 要 让 主 工 程 知道 当前 业务 的 bean 路 径 
并 加 入 scan 列 表 中 ， 人 否则 在 Spring 局 动 的 过 程 中 没 
^H ZNE1Eclient'F Fr BJbeanZX A Spring 4s, 2 $8 
也 就 没 法 生效 了 ， 但 是 ， 随 着 业务 的 增长 ， 模 块 也 
会 越 来 越 多 、 越 来 越 分 散 ， 大 量 的 配置 在 主 函 数 中 
AEG, Se RE ASE as EA RS of AL 
根据 职责 划分 原则 ， 以 上 的 例子 中 主 模块 只 关心 目 
己 是 否 使 用 外 部 依赖 的 模块 以 及 对 应 的 接口 束 好 
了 ， 再 去 让 主 模块 感知 对 应 的 路 径 等 细节 信息 显然 
是 不 合适 的 。 于 是 乎 ， 在 Spring Boot 出 来 之 前 我 们 
会 尝试 把 Scan 等 配置 项 写 入 XML 里面， 然后 让 主 函 
数 直接 引用 配置 项 ， 这 样 ， 主 函数 知道 的 事情 就 进 
一 步 减少 了 ， 但 是 还 有 没有 更 好 的 解决 方式 呢 ， 或 
者 ， 还 有 没有 更 好 的 办 法 能 让 主 函 数 做 更 少 的 事情 
We? Spring Boot 做 到 了 这 一 点 ， 继 续 追 加 代码 ， 添 
加 目 动 配置 项 : 



































package com.spring.study; 


import org.springframework.context.annotation.ComponentScan; 
import org.springframework.context.annotation.Configuration; 


QConfiguration 
QComponentScan( ("com.spring.study.module")) 
public class HelloServiceAutoConfiguration { 


j 


BATA, fEHelloServiceAutoConfiguration 类 
中 并 没有 逻辑 实现 ， 它 存在 的 目的 仅仅 是 通过 注解 
进行 配置 的 声明 ， 我 们 可 以 在 ComponentScan 中 加 
入 这 个 模块 的 容器 扫描 路 径 。 


当然 ， 如 果 仅 仅 是 到 此 ，Starter 还 是 没有 开发 
完成 ， 还 需要 最 后 一 步 ， 那 残 是 声明 这 个 配置 文件 
的 路 径 ， 在 Spring 的 跟 路 径 下 建立 META- 
INF/spring.factories 文件 ， 并 声明 配置 项 路 径 〈 见 
图 14-4) : 











org.springframework.boot.autoconfigure.EnableAutoConfigurat 
ion=\ 


com.spring.study.HelloServiceAutoConfiguration 





= studyclient src main - resources META-INF ` 9$ spring.factories 
| E Project ~ : %- 1^ @ spring.factories 


org. springframework. boot .autoconfigure.EnableAutoConf guration=\ 
Om. Sp g.study.Hel figuratio 





HeLLoServiceAutoConfig 


Bs ja 
om 
spring 
study 
client 
module 
D HelloService 
© HelloServicelmpl 
© HelloServiceAutoConfigurat 
sources 
META-INF 
*8 spring.factories 
test 
BD jav: 
B target 
M pom.xml 
as 


图 14-4  spring.factoriesfid i. 


到 此 ， 一 个 标准 的 Starter 就 开发 完成 了 ， 它 有 
什么 用 或 者 说 它 怎么 使 用 呢 ? 我 们 来 看 一 下 它 的 使 
FATT X. 


修改 前 言 中 的 web 工程 ， 加 入 依赖 : 


<dependency> 
«groupId»com.springstudy«c/groupId» 
<artifactId>study-client-starter</artifactId> 


«version»1.0-SNAPSHOT«/version» 
</dependency> 





RY, E pEControllenZ 44, PER AI Be S| 
Is 如 下 所 示 : 





package com.springstudy.controller; 


import com.spring.study.module.HelloService; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RestController; 


QRestController 
public class TestController ( 


QAutowired 


private HelloService helloService; 


QRequestMapping("/") 
String home() ( 
return helloService.sayHello(); 


j 


读者 会 发 现 ， 我 们 刚才 开发 的 Starter 对 于 使 用 
者 来 说 非常 的 方便 ， 除 了 在 pom 中 引入 依赖 ， 什 么 
都 不 做 就 可 以 直接 使 用 模块 内 部 的 接口 注入 : 


QAutowired 
private HelloService helloService; 


xxn EERIE RR IEE NDE, [IIIS 
后 续 的 模块 拆 分 提供 了 便利 ， 因 为 当 业 务 逐 渐 复 杂 
的 时 候 我 们 会 引入 大 量 的 中 间 件 ， 而 这 些 中 间 件 的 
配置 、 人 依赖、 以 及 初始 化 是 非常 麻烦 的 ， 现 在 有 了 
Starter 模 式 ， 它 帮 我 们 做 到 了 只 关注 于 逻辑 本 里。 


ASA, Spring Boot 是 如 何 做 到 的 呢 ? 








14.3 ”探索 SpringApplication 忆 动 
Spring 


RATER FI E K ZTA O 
SpringBootDemolApplication， 发 现 这 个 入 口 的 启动 
还 是 比较 奇怪 的 ， 这 也 是 Spring Boot 启 动 的 必要 做 
法 ， 那 么 ， 这 也 可 以 作为 我 们 分 析 Spring Boot 的 入 
LI: 


QSpringBootApplication 


public class SpringBootDemoi1Application { 
public static void main(String[] args) { 
SpringApplication 


.run(SpringBootDemoiApplication.class, args); 


j 
j 





当 顺 着 SpringApplication.run 方 法 进入 的 时 候 我 
们 找到 了 SpringApplication 的 一 个 看 似 核心 还 辑 的 
JjiE: 





public ConfigurableApplicationContext run(String... args) { 
StopWatch stopWatch = new StopWatch(); 
stopWatch.start(); 
ConfigurableApplicationContext context - null; 
FailureAnalyzers analyzers - null; 
configureHeadlessProperty(); 
SpringApplicationRunListeners listeners - getRunListeners(ar 
gs); 
listeners.starting(); 
try { 
ApplicationArguments applicationArguments - new DefaultAp 
plicationArguments( 
args); 
ConfigurableEnvironment environment - prepareEnvironment( 
listeners, 
applicationArguments); 
Banner printedBanner - printBanner(environment); 
context - createApplicationContext(); 


analyzers - new FailureAnalyzers(context); 
prepareContext(context, environment, listeners, applicati 
onArguments, 


printedBanner); 
refreshContext(context); 


afterRefresh(context, applicationArguments); 


listeners.finished(context, null); 
stopWatch.stop(); 
if (this.logStartupInfo) { 
new StartupInfoLogger(this.mainApplicationClass) 
.logStarted(getApplicationLog(), stopWatch); 


return context; 

J 

catch (Throwable ex) { 
handleRunFailure(context, listeners, analyzers, ex); 
throw new IllegalStateException(ex); 


j 
i 





在 这 里 ， 我 们 发 现 了 几 个 关键 字眼 : 


context = createApplicationContext(); 
refreshContext(context); 


afterRefresh(context, applicationArguments); 








如 果 读 者 看 过 之 前 的 内 容 ， 束 会 知道 ， 我 们 曾 
经 在 第 5 章 介 绍 过 Spring 完 整 的 初始 化 方案 ， 其 中 整 
最 为 核心 的 就 是 SpringContext 的 创建 、 初 始 化 、 刷 
新 等 。 那 么 我 们 可 以 直接 进入 查看 其 中 的 逻辑 ， 同 
时 ，Spring 作 为 一 个 全 球 都 在 使 用 的 框架 ， 会 有 非 
第 多 的 需要 考虑 的 问题 ， 我 们 在 阅读 源码 的 过 程 中 
只 需要 关系 核心 的 主流 程 ， 了 解 其 工作 原理 ， 并 在 








阅读 的 过 程 中 感受 它 的 代码 风格 以 及 设计 理念 就 好 
了 ， 如 果真 的 奶 求 理解 每 一 行 代 人 码 真 的 是 非常 耗 时 
的 一 件 事情 ， 毕 葛 我 们 陪读 源码 的 目的 大 多 数 是 成 
长 而 不 是 真 的 要 去 维护 Spring。 





14.3.1 SpringContext 创 建 


protected ConfigurableApplicationContext createApplicationConte 
xt() { 
Class<?> contextClass = this.applicationContextClass; 
if (contextClass == null) { 
try { 
contextClass = Class.forName(this.webEnvironment 
? DEFAULT WEB CONTEXT CLASS : DEFAULT CONTEXT CL 


catch (ClassNotFoundException ex) { 
throw new IllegalStateException( 
"Unable create a default ApplicationContext, " 
* "please specify an ApplicationContextCla 


ex); 


return (ConfigurableApplicationContext) BeanUtils.instantiat 
e(contextClass); 


j 





这 个 函数 似乎 没有 什么 特别 之 处 ， 无 非 束 是 实 
例 化 一 个 ApplicationContext， 因 为 
ApplicationContext 是 Spring 存 在 的 基础 。 而 对 应 的 


SpringContext 候 选 类 如 下 : 


public static final String DEFAULT WEB CONTEXT CLASS 


- "org.springframework." 
* "boot.context.embedded.AnnotationConfigEmbeddedWebAppli 


cationContext"; 


private static final String[] WEB ENVIRONMENT CLASSES 


= ( "javax.servlet.Servlet", 
"org.springframework.web.context.ConfigurableWebApplicati 


onContext" }; 





这 里 有 个 关键 的 判断 ，this.webEnvironment， 
如 果 读 者 没有 看 过 代码 很 容易 会 忽略 ， 但 是 这 里 将 
成 为 在 前 言 中 提 到 的 Spring 如 何 自动 化 启动 Tomcat 
的 关键 ， 我 们 将 会 在 后 续 章 节 详 细 介 绍 。 








14.3.2 bean 的 加 载 


2k 53:3 [HB Ex prepareContext: 





private void prepareContext(ConfigurableApplicationContext cont 
ext, 


ConfigurableEnvironment environment, SpringApplicationRun 
Listeners listeners, 
ApplicationArguments applicationArguments, Banner printed 
Banner) ( 
context.setEnvironment (environment); 
postProcessApplicationContext(context); 
applyInitializers(context); 
listeners.contextPrepared(context); 


if (this.logStartupInfo) { 
logStartupInfo(context.getParent() == null); 
logStartupProfileInfo(context); 


// Add boot specific singleton beans 
context.getBeanFactory().registerSingleton("springApplicatio 
nArguments", 
applicationArguments); 
if (printedBanner !- null) ( 
context.getBeanFactory().registerSingleton("springBootBan 
ner", printedBanner); 


j 


// Load the sources 
Set«Object» sources - getSources(); 
Assert.notEmpty(sources, "Sources must not be empty"); 
load(context, sources.toArray(new Object[sources.size()])); 


listeners.contextLoaded(context); 





这 里 面 的 load 函 数 是 我 们 比较 感 兴 趣 的 ， 代 码 


如 下 : 





protected void load(ApplicationContext context, Object[] source 
s) { 
if (logger.isDebugEnabled()) { 
logger .debug( 
"Loading source " + StringUtils.arrayToCommaDelimit 


edString(sources)); 


BeanDefinitionLoader loader = createBeanDefinitionLoader ( 
getBeanDefinitionRegistry(context), sources); 
if (this.beanNameGenerator != null) { 
loader .setBeanNameGenerator(this.beanNameGenerator); 


if (this.resourceLoader != null) { 
loader .setResourceLoader(this.resourceLoader ); 


} 
if (this.environment !- null) { 
loader.setEnvironment(this.environment); 


} 
loader.load(); 








相信 当 读 者 看 到 BeanDefinitionLoader 这 个 类 的 





时 候 基 本 上 就 已 经 知道 后 续 的 逻辑 了 ， bean 的 加 载 
作为 本 书 中 最 核心 的 部 分 早 在 第 1 章 束 已 经 开始 分 
Wr. 





14.3.3 ”Spring 扩展 属性 的 加 载 


protected void refresh(ApplicationContext applicationContext) { 
Assert.isInstanceOf(AbstractApplicationContext.class, applic 
ationContext); 


((AbstractApplicationContext) applicationContext).refresh(); 


j 





对 于 Spring 的 扩展 属性 加 载 则 更 为 简单 ， 因 为 
这 些 都 是 Spring 本 喘 原 有 的 东西 ，Spring Boot 仅 仅 
E H refreshi Rint, Nd refresh 
的 详细 逻辑 ， 可 以 回 到 第 5 章 进 一 步 查 看 。 





14.3.4 mz 


ait RK, Spring Boot 的 启动 并 不 是 我 们 想象 
的 那么 神秘 ， 按 照 约定 大 于 配置 的 原则 ， 内 置 了 
Spring 原 有 的 局 动 类 ， 并 在 启动 的 时 候 局 动 及 刷 
新 ， 仅 此 而 已 。 


org.springframework.context.annotation.AnnotationConfigApplicat 
ionContext 


14.4 Starter 目 动 化 配置 原理 





我 们 已 经 知道 了 Spring Boot 如 何 局 动 Spring， 
但 是 目前 为 止 我 们 并 没有 揭 开 Spring Boot 的 面纱 ， 
Fea Starter xe WA Ce? 这 些 馆 辑 现在 看 来 只 
能 体现 在 注解 SpringBootApplication 本 里 了 。 








继续 追查 代码 ， 看 一 看 SpringBootApplication 
注解 内 容 : 





QTarget(ElementType.TYPE) 
QRetention(RetentionPolicy.RUNTIME) 
QDocumented 

QInherited 
QSpringBootConfiguration 
QEnableAutoConfiguration 


@ComponentScan(excludeFilters = { 

@Filter(type = FilterType.CUSTOM, classes = TypeExcludeFi 
lter.class), 

QFilter(type - FilterType.CUSTOM, classes - AutoConfigura 
tionExcludeFilter.class) )) 


public Qinterface SpringBootApplication { 


a XXX PIA... 





这 其 中 我 们 更 关注 SpringBootApplication 上 的 
注解 内 容 ， 因 为 注解 具有 传递 性 ， 
EnableAutoConfiguration 是 个 非常 特别 的 注解 ， 它 
Je Spring Boot 的 全 局 开关 ， 如 琳 把 这 个 注解 去 挥 ， 
则 一 切 Starter 都 会 失效 ， 这 就 是 约定 大 于 配置 的 淤 
规则 ， 那 么 ，Spring Boot 的 核心 很 可 能 就 藏 在 这 个 
注解 里 面 : 











QSuppressWarnings("deprecation") 
QTarget(ElementType.TYPE) 
QRetention(RetentionPolicy.RUNTIME) 

@Documented 

@Inherited 

@AutoConfigurationPackage 
@Import(EnableAutoConfigurationImportSelector.class) 


public @interface EnableAutoConfiguration { 
Xxx Al AR... 





EnableAutoConfigurationImportSelector/F 7; 
Starter 上 自动 化 导入 的 关键 选项 终于 浮现 出 来 ， 那 么 
Spring 是 怎么 识别 并 让 这 个 注解 起 作用 的 呢 ? 我 们 


AST AB AMARE. MARRA —A SR 
古 哪个 方法 调用 了 它 ， 就 可 以 顺 滕 探 瓜 找到 最 终 的 
调用 点 。 


public class EnableAutoConfigurationImportSelector extends Auto 
ConfigurationImportSelector { 


QOverride 
protected boolean isEnabled 


(AnnotationMetadata metadata) { 
if (getClass().equals(EnableAutoConfigurationImportSelect 


or.class)) { 
return getEnvironment().getProperty( 
EnableAutoConfiguration.ENABLED OVERRIDE PROPERT 
Y, Boolean.class, true); 


return true; 


j 





14.4.1 spring.factories 的 加 载 








顺 看 思路 反问 但 找 ， 看 一 看 究竟 是 谁 在 哪里 调 
用 了 isEnabled 函 数 ， 强 大 的 编译 器 很 容器 帮 我 们 定 
位 到 了 AutoConfigurationImportSelector 类 的 方法 : 





QOverride 
public String[] selectimports 


(AnnotationMetadata annotationMetadata) { 
if (!isEnabled 


(annotationMetadata)) { 
return NO IMPORTS; 
j 


try { 
AutoConfigurationMetadata autoConfigurationMetadata - Aut 


oConfigurationMetadataLoader 
.loadMetadata(this.beanClassLoader); 
AnnotationAttributes attributes - getAttributes(annotatio 
nMetadata); 
List<String> configurations = getCandidateConfigurations 


(annotationMetadata, 
attributes); 

configurations - removeDuplicates(configurations); 

configurations - sort(configurations, autoConfigurationMe 
tadata); 

Set«String» exclusions - getExclusions(annotationMetadata 
, attributes); 

checkExcludedClasses(configurations, exclusions); 

configurations.removeAll(exclusions); 

configurations - filter(configurations, autoConfiguration 
Metadata); 

fireAutoConfigurationlImportEvents(configurations, exclusi 
ons); 

return configurations.toArray(new String[configurations.s 


ize()]); 
j 


catch (IOException ex) { 
throw new IllegalStateException(ex); 


j 





它 古 一 个 非常 核心 的 函数 ， 可 以 帮 我 们 解释 很 
多 问题 。 在 上 面 的 函数 中 ， 有 一 个 是 我 们 比较 关注 
HJgetCandidateConfigurations Pj 2X : 





protected List«String» getCandidateConfigurations(AnnotationMet 
adata metadata, 


AnnotationAttributes attributes) { 


List<String> configurations = SpringFactoriesLoader.loadFact 
oryNames( 


getSpringFactoriesLoaderFactoryClass(), getBeanClassLo 
ader()); 


Assert.notEmpty(configurations, 
"No auto configuration classes found in META-INF/sprin 
g.factories 


. If you " 
* "are using a custom packaging, make sure that 
file is correct."); 
return configurations; 


j 





从 上 面 的 函数 中 我 们 看 到 了 META- 
INF/spring,.factories， 在 我 们 之 前 演示 的 环 方 ， 按 照 





约定 大 于 配置 的 原则 ，Starter 如 果 要 生效 则 必须 要 
在 META-INF 文 件 下 下 建立 Spring.factories 文 件 ， 并 
把 相关 的 配置 类 声明 在 里 面 ， 虽 然 这 仅仅 是 一 个 报 
音 异 第 提示 ， 但 是 其 实 我 们 已 经 可 以 推 基 出 来 这 一 
定 陨 是 这 个 馆 辑 的 处 理 之 处 ， 继 续 进 入 


SpringFactoriesLoader2s: 

















public static List<String> loadFactoryNames(Class<?> factoryCla 
ss, ClassLoader classLoader) ( 
String factoryClassName - factoryClass.getName(); 
try { 
Enumeration<URL> urls = (classLoader !- null ? classLoade 
r.getResources 
(FACTORIES RESOURCE LOCATION 


) 


OCATION 


ClassLoader.getSystemResources(FACTORIES RESOURCE L 


)); 
List«String» result = new ArrayList<String>(); 
while (urls.hasMoreElements()) { 
URL url - urls.nextElement(); 
Properties properties - PropertiesLoaderUtils.loadProp 
erties(new UrlResource(url)); 
String factoryClassNames - properties.getProperty(fact 
oryClassName); 
result.addAll(Arrays.asList(StringUtils.commaDelimited 
ListToStringArray 
(factoryClassNames))); 


return result; 
} 
catch (IOException ex) { 
throw new IllegalArgumentException("Unable to load [" + f 
actoryClass.getName() + 
"] factories from location [" + FACTORIES RESOURCE _- 
LOCATION + "]", ex); 
} 


} 





而 上 面 函 数 中 对 
FACTORIES RESOURCE LOCATION 的 定义 为 : 


public static final String FACTORIES RESOURCE LOCATION = "META- 
INF/spring.factories"; 








至 此 ， 我 们 终于 明日 了 为 什么 Starter 的 生效 必 
须要 依赖 于 配置 META-INF/spring.factories 文 件 ， 因 
为 在 启动 过 程 中 有 一 个 便 编 码 的 人 远 辑 就 是 会 扫 摘 各 
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取出 来 后 又 是 怎么 跟 Spring 整 合 的 呢 ? 或 者 说 
AutoConfigurationImportSelector.selectImports 方 法 后 
把 加 载 的 类 又 委 托 给 谁 继 续 处 理 了 呢 ? 


14.4.2 ”factories 调 用 时 友 图 


META-INF/spring.factories 中 的 配置 文件 是 如 何 
与 Spring 整 合 的 呢 ? 其 路 径 还 是 比较 深 的 ， 这 里 就 
不 大 段 地 放 代 码 了 ， 作 者 通过 一 个 图 去 理 清 它 的 好 
AH. 





PostProcessorRegistrationDelegate ^ ConfigurationClassPostProcessor ConfigurationClassParser | —AutoConfigurationImportSelector 


14-5 AutoConfigurationImportSelector§ Spring 的 整合 
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AutoConfigurationImportSelector 的 调用 链 路 ， 当 然 
这 个 链 路 还 有 非常 多 的 额外 分 文 被 忽略 。 不 过 至 少 
从 上 图 中 我 们 可 以 很 清晰 地 看 到 
AutoConfigurationImportSelector 与 Spring 的 整合 过 
程 ， 在 这 个 调用 链 中 最 核心 的 束 古 Spring Boot 使 用 
了 Spring 提供 的 BeanDefinitionRegistryPostProcessor 
扩展 点 并 实现 了 ConfigurationClassPostProcessor 
类 ， 从 而 实现 了 spring 之 上 的 一 系列 人 逻辑 扩展 ， 让 
我 们 看 一 下 ConfigurationClassPostProcessor 的 继承 
关系 ， 如 图 14-6 所 示 : 
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图 14-6 AutoConfigurationImportSelector4k AKA 


当然 Spring 还 提供 了 非常 多 不 同 阶 段 的 扩展 
扩 ， 读 者 可 以 通过 前 几 间 的 内 容 获 取 详 细 的 扩展 后 
以 及 实现 原理 。 


14.43 ”配置 类 的 解析 


截止 到 目前 我 们 知道 了 Starter 为 什么 要 求 默 认 
将 自身 入 口 配置 写 在 META-INF 文 件 下 的 
spring,.factories 文 件 中 ， 以 及 
AutoConfigurationImportSelector 的 上 下 文 调用 链 
路 ， 但 是 通过 AutoConfigurationImportSelector. 
selectImports 方 法 返回 后 的 配置 类 又 是 如 何 进一步 
处 理 的 呢 ? 对 照 图 14-5 我 们 抽出 
ConfigurationClassParser 的 
processDeferredImportSelectors 方 法 代码 查看 : 








private void processDeferredImportSelectors() { 
List«DeferredImportSelectorHolder» deferredImports = this.de 
ferredImportSelectors; 
this.deferredImportSelectors - null; 
Collections.sort(deferredImports, DEFERRED IMPORT COMPARATOR 
); 


for (DeferredImportSelectorHolder deferredImport : deferredI 
mports) { 
ConfigurationClass configClass - deferredImport.getConfig 
urationClass(); 
try { 
String[] imports = deferredImport.getImportSelector(). 
selectImports(configClass. 
getMetadata()); 


processImports(configClass, asSourceClass(configClass) 
, asSourceClasses(imports), 
false); 


catch (BeanDefinitionStoreException ex) ( 
throw ex; 


catch (Throwable ex) { 
throw new BeanDefinitionStoreException( 


"Failed to process import candidates for configu 
ration class [" + 

configClass.getMetadata().getClassName() + "|", 
ex); 


j 
j 





其 中 


String[] imports = 
deferredImport.getlImportSelector().selectImports(configClass.g 


etMetadata()); 








的 imports 对 应 的 就 是 我 们 定义 的 配置 文件 中 配 
置 的 类 ， 通 过 断 点 调试 ， 如 图 14-7 所 示 。 


private void processDeferredImportSelectors() { 
List<DeferredImportSelectorHolder> deferredImports = this.deferredImportSelectors; deferredimports: size = 1 
this.deferredImportSelectors = null; deferredImportSelectors: null 
Collections.sort(deferredImports, DEFERRED IMPORT COMPARATOR); 


for (DeferredImportSelectorHolder deferredImport : deferredImports) { deferredImport: ConfigurationClassParser$Deferred 
ConfigurationClass configClass = deferredImport.getConfigurationClass(); configClass: "ConfigurationClass: beanName 













g "id - [] imports - deferredImp nportSelector().selectImports(configClass.getMetadata()); imports: ("org. 
* | | processImports(configClass, asSourceClass(configClass), asSourceClasses(imports), orc 
e e i Evaluate 
Expression: 
imports E 
Use CA to add to Watcht 
Result: 


v G result = {String[21]@3036} 
> = 0 ="org.springframework.boot.autoconfigure.context.MessageSourceAutoConfiguration" 

| > &1-"org.springframework.boot.autoconfigure.context.PropertyPlaceholderAutoConfiguration" 
e > £2 =“org.springframework.boot.autoconfigure.jackson. JacksonAutoConfiguration" 
| > = 3 ="org.springframework.boot.autoconfigure.websocket. WebSocketAutoConfiguration" 
> = 4 ="org.springframework.boot.autoconfigure. web. EmbeddedServietContainerAutoConfiguration" 
> = 5 ="org.springframework.boot.autoconfigure.web.DispatcherServietAutoConfiguration" 
> = 6 ="“org.springframework.boot.autoconfigure. validation. ValidationAutoConfiguration" 
> =7 ="org.springframework.boot.autoconfigure.web.ErrorMvcAutoConfiguration" 
> = 8 ="org.springframework.boot.autoconfigure.web. WebMvcAutoConfiguration" 
| > 9 = "com.spring.study.HelloServiceAutoConfiguration" 
| > = 10 = "org.springframework.boot.autoconfigure.jmx.JmxAutoConfiguration" 
> = 1 = "org.springframework.boot.autoconfigure.admin. SpringApplicationAdminJmxAutoConfiguration" 
a i > = 12 = "org.springframework.boot.autoconfigure.cache.CacheAutoConfiguration" 

| > = 13-"org.springframework.boot.autoconfigure.context.ConfigurationPropertiesAutoConfiguration" 
2 





> = 14 = "org.springframework.boot.autoconfigure.web.HttpMessageConvertersAutoConfiguration" 
> = 15 = "org.springframework.boot.autoconfigure.info.ProjectinfoAutoConfiguration" 

> = 16 = "org.springframework.boot.autoconfigure.mail.MailSenderValidatorAutoConfiguration" 

> = 17 = "org.springframework. boot.autoconfigure. web. HttpEncodingAutoConfiguration” 

» = 18 = "org.springframework.boot.autoconfigure.web.MultipartAutoConfiguration" 

> = 19 = "org.springframework. boot.autoconfigure.web.ServerPropertiesAutoConfiguration” 


ont 
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? Close 


图 14-7 ”imports 返 回 值 查看 


也 就 是 说 在 Spring 局 动 的 时 候 会 扫描 所 有 JAR 
中 的 Spring.factories 定义 的 类 ， 而 这 些 对 于 用 户 来 
说 如 果 不 是 通过 调试 信息 可 能 根本 就 感知 不 到 。 


那么 也 束 是 说 ， 下 面 运行 代码 束 古 配置 文件 的 
Kb SHS TE: 








processImports(configClass, asSourceClass(configClass),asSourceC 
lasses(imports), false); 
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各 种 分 文 的 处 理 ， 我 们 不 妨 和 完 通 过 时 序 图 从 全 局 的 
角度 了 解 一 下 它 的 处 理 全 貌 。 


ConfigurationClassPostProcessor | | ConfigurationClassParser | EnableAutoConfigurationImportSelector | ConfigurationClassBeanDefinitionReader 





2:processConfigBeanDefinitions 


14-8 ”Parser 解 析 流 程 


图 14-8 是 在 图 14-5 基 础 上 更 细 粒 度 的 突出 解析 
过 程 的 时 序 图 ， 从 时 序 图 中 我 们 可 以 大 至 看 到 
Spring 的 全 局 处 理 流程 。 


。ConfigurationClassPostProcessor 作 为 Spring 扩展 
点 是 Spring Boot 一 系列 功能 的 基础 入 口 。 


ConfigurationClassParser 作 为 解析 职责 的 基本 处 
理 类 ,涵盖 了 各 种 解析 处 理 的 逻辑 ， 如 
@Import. @Bean, @ImportResource 、 
@PropertySource、@ComponentScan 等 注解 都 是 
在 这 个 注解 类 中 完成 的 ， 而 这 个 类 对 外 开放 的 
函数 入 口 就 是 parse 方 法 。 对 应 时 序 图 中 的 步骤 
or 

在 完成 步骤 3 后 ， 所 有 解析 的 结果 已 经 通过 3.2.2 
步骤 放 在 了 parse 的 configurationClasses 属 性 中 ， 
这 时 候 对 这 个 属性 进行 统一 的 Spring bean 便 编码 
注册 ， 注 册 思 辑 统 一 委托 给 
ConfigurationClassBeanDefinitionReader， 对 外 的 
接口 是 loadBeanDefinitions， 对 应 步骤 4。 

当然 ， 在 parse 中 的 处 理 是 最 复杂 的 ，parse 中 首 
先 会 处 理 目 己 本 喘 能 扫 摘 到 的 bean 注 册 逻 和 辑 ， 
然后 才 会 处 理 Spring.factories 定 义 的 配置 。 处 理 
Spring.factories 定 义 的 配置 首先 殉 是 要 加 载 配 置 
类 ， 这 个 时 候 
EnableAutoConfigurationImportSelector 提 供 的 
selectImports ®t 4 Jk EHH S, 'eokRIBIBS RO ELAS 
需要 进行 进一步 解 机 ， 因 为 这 些 配置 类 中 可 能 
对 应 不 同 的 类 型 ， 如 @Import、@Bean、 
@ImportResource ~ @PropertySource, 
@ComponentScan， 而 这 些 类 型 义 有 不 同 的 处 理 
逻辑 ， 例 如 ComponentScan， 我 们 就 能 猜 到 这 里 
面 除 了 解析 外 一 定 还 会 有 递归 解析 的 处 理 逻 


























辑 ， 因 为 很 有 可 能 通过 ComponentScan 又 扫描 出 
了 另 一 个 ComponentScan 配 置 。 


14.4.4 “Componentscan 的 切入 点 


这 里 重点 讲解 一 下 doProcessConfigurationClass 
函数 ， 我 们 熟悉 的 很 多 注解 逻辑 的 实现 都 在 这 里 : 








protected final SourceClass doProcessConfigurationClass(Configu 
rationClass configClass, 
SourceClass sourceClass) 

throws IOException { 


// Recursively process any member (nested) classes first 
processMemberClasses(configClass, sourceClass); 


// Process any QPropertySource annotations 


for (AnnotationAttributes propertySource : AnnotationConfigU 
tils.attributesForRepeatable( 
sourceClass.getMetadata(), PropertySources.class, 
org.springframework.context.annotation.PropertySource. 
class)) { 
if (this.environment instanceof ConfigurableEnvironment ) 


{ 


processPropertySource(propertySource) ; 


else { 
logger.warn("Ignoring @PropertySource annotation on [" 
+ sourceClass.getMetadata().getClassName() + 
"]. Reason: Environment must implement Configura 
bleEnvironment"); 
} 
} 


// Process any QComponentScan annotations 


Set<AnnotationAttributes> componentScans = AnnotationConfigU 
tils.attributesForRepeatable( 


sourceClass.getMetadata(), ComponentScans.class, Compo 
nentScan.class); 


if (!componentScans.isEmpty() && 
!Ithis.conditionEvaluator.shouldSkip(sourceClass.getMet 
adata(), ConfigurationPhase. 
REGISTER BEAN)) ( 
for (AnnotationAttributes componentScan : componentScans) 
{ 
// The config class is annotated with @ComponentScan - 
> perform the scan immediately 
Set<BeanDefinitionHolder> scannedBeanDefinitions = 
this.componentScanParser.parse(componentScan, so 
urceClass.getMetadata().getClassName()) 


// Check the set of scanned definitions for any furthe 
r config classes and 
parse recursively if needed 
for (BeanDefinitionHolder holder : scannedBeanDefiniti 
ons) ( 
// 对 扫描 出 来 的 类 进行 过 滤 


if (ConfigurationClassUtils.checkConfigurationClass 




















Candidate( 
holder.getBeanDefinition(), this.metadataRead 
erFactory)) { 


// 将 所 有 扫 





Hr 




















出 来 的 类 委托 到 parse 方 法 中 递归 处 理 
parse(holder.getBeanDefinition().getBeanClassNam 
e(), holder.getBeanName()); 























j 


// Process any QImport annotations 


processImports(configClass, sourceClass, getImports(sourceCl 
ass), true); 


// Process any @ImportResource annotations 


if (sourceClass.getMetadata().isAnnotated(ImportResource.cla 
ss.getName())) { 
AnnotationAttributes importResource = 
AnnotationConfigUtils.attributesFor(sourceClass.get 
Metadata(), ImportResource.class); 
String[] resources - importResource.getStringArray("locat 
ions"); 
Class<? extends BeanDefinitionReader» readerClass = impor 
tResource.getClass("reader"); 
for (String resource : resources) { 
String resolvedResource = this.environment.resolveRequ 
iredPlaceholders(resource); 
configClass.addImportedResource(resolvedResource, read 
erClass); 


j 
j 


// Process individual QBean methods 


Set«MethodMetadata» beanMethods - retrieveBeanMethodMetadata 
(sourceClass); 
for (MethodMetadata methodMetadata : beanMethods) { 
configClass.addBeanMethod(new BeanMethod(methodMetadata, 
configClass)); 


d 


// Process default methods on interfaces 


processInterfaces(configClass, sourceClass); 


// Process superclass, if any 
if (sourceClass.getMetadata().hasSuperClass()) { 
String superclass - sourceClass.getMetadata().getSuperCla 
ssName( ); 
if (!superclass.startsWith("java") && !this.knownSupercla 
sses.containsKey(superclass)) ( 
this.knownSuperclasses.put(superclass, configClass); 


// Superclass found, return its annotation metadata an 
d recurse 
return sourceClass.getSuperClass(); 
} 
} 


// No superclass -> processing is complete 
return null; 





而 以 上 函数 中 传递 过 来 的 参数 


ConfigurationClass configClass 就 是 spring.factories 中 





定义 的 配置 类 ， 这 里 我 们 重点 关 注 一 下 
ComponentScan 注 解 的 : 实现 逻辑 ， 首 先 通 过 代码 


Set<AnnotationAttributes> componentScans = AnnotationConfigU 
tils.attributesForRepeatable( 
sourceClass.getMetadata(), ComponentScans.class, Compo 


nentScan.class); 
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主要 的 扫描 路 径 信 息 ， 然 后 委托 给 


ComponentScanAnnotationParser 的 parse 进 一 步 扫 


fii: 





parse(holder.getBeanDefinition().getBeanClassName(), holder.ge 
tBeanName( )); 


MEM 


当然 ， 顺 着 思路 继续 跟 进 parse 方 法 ， 这 里 面 还 
会 有 一 些 额 外 的 处 理 分 文 ， 我 们 顺 痢 主流 程 一 层 一 
层 跟 进 ， 直 到 进入 一 个 核心 解析 类 
ComponentScanAnnotationParser 的 函数 中 。 





public Set«BeanDefinitionHolder» parse(AnnotationAttributes com 
ponentScan, final String 
declaringClass) { 


Assert.state(this.environment !- null, "Environment must not 
be null"); 
Assert.state(this.resourceLoader !- null, "ResourceLoader mu 


st not be null"); 


ClassPathBeanDefinitionScanner scanner - new ClassPathBeanDe 
finitionScanner(this.registry, 


componentScan.getBoolean("useDefaultFilters"), this.en 
vironment, this.resourceLoader ); 


Class<? extends BeanNameGenerator> generatorClass = componen 
tScan.getClass("nameGenerator"); 
boolean useInheritedGenerator - (BeanNameGenerator.class -- 
generatorClass); 
scanner.setBeanNameGenerator(uselnheritedGenerator ? this.be 
anNameGenerator 
BeanUtils.instantiateClass(generatorClass)); 


// scopedProxy 属 性 构造 
ScopedProxyMode scopedProxyMode = componentScan.getEnum("sco 
pedProxy"); 
if (scopedProxyMode !- ScopedProxyMode.DEFAULT) ( 
scanner .setScopedProxyMode(scopedProxyMode) ; 





else { 
Class<? extends ScopeMetadataResolver> resolverClass = co 


mponentScan.getClass 

("scopeResolver"); 
scanner.setScopeMetadataResolver(BeanUtils.instantiateCla 

ss(resolverClass)); 


j 





// resourcePattern 属 性 构造 
scanner.setResourcePattern(componentScan.getString("resource 
Pattern")); 


// includeFiltersit& 
for (AnnotationAttributes filter : componentScan.getAnnotati 
onArray("includeFilters")) { 
for (TypeFilter typeFilter : typeFiltersFor(filter)) { 
scanner.addIncludeFilter(typeFilter); 


j 
j 


// excludeFilters 属 性 设置 
for (AnnotationAttributes filter : componentScan.getAnnotati 
onArray("excludeFilters")) { 
for (TypeFilter typeFilter : typeFiltersFor(filter)) { 
scanner.addExcludeFilter(typeFilter); 





j 
} 


boolean lazyInit = componentScan.getBoolean("lazyInit"); 
if (lazyInit) { 
scanner ..getBeanDefinitionDefaults().setLazyInit(true); 


j 


//basePackagesix E 
Set«String» basePackages = new LinkedHashSet<String>(); 
String[] basePackagesArray - componentScan.getStringArray("b 
asePackages"); 
for (String pkg : basePackagesArray) { 
String[] tokenized - StringUtils.tokenizeToStringArray(th 
is.environment.resolvePlaceholders 


(pkg), 


MITERS); 
basePackages.addAll(Arrays.asList(tokenized)); 


ConfigurableApplicationContext.CONFIG LOCATION DELI 


j 


for (Class«?» clazz : componentScan.getClassArray("basePacka 
geClasses")) ( 


basePackages.add(ClassUtils.getPackageName(clazz)); 


} 
if (basePackages.isEmpty()) { 
basePackages.add(ClassUtils.getPackageName(declaringClass 
)); 
} 


scanner.addExcludeFilter(new AbstractTypeHierarchyTraversing 
Filter(false, false) ( 
@Override 
protected boolean matchClassName(String className) { 
return declaringClass.equals(className) ; 
} 
3); 
return scanner.doScan(StringUtils.toStringArray(basePackages 


)); 





而 上 面 提 到 的 最 为 核心 的 解析 工具 类 
ClassPathBeanDefinitionScanner 就 是 Spring 原生 的 解 
析 类 ， 这 是 Spring 核心 解析 类 ， 它 通过 字 节 码 扫 朱 
的 方式 ， 效 率 要 比 通 单 我们 用 的 反正 机 制 效率 要 高 
很 多 ， 如 果 旋 者 在 日 单 工作 中 有 扫描 路 径 下 类 的 需 





求 ， 哪 怕 脱 离 了 Spring 环 境 也 可 以 直接 使 用 这 个 工 
具 类 。 不 知道 读者 是 否 还 清楚 ， 在 介绍 整合 Mybatis 
那 一 章 中 Mybatis 的 动态 扫描 就 是 封装 了 类 似 的 类 ， 
该 者 不 妨 回 过 头 再 去 回顾 下 那 一 草 的 内 容 。 








14.5 Conditional) Lii] S EN 


14.5.1 _ Conditional 使 用 


Spring 提供 了 一 个 更 通用 的 基于 条 件 的 bean 的 
创建 45 FH(Q Conditional? fff. (2Conditionalf& 75 
满足 的 某 一 个 特定 条 件 创 建 一 个 特定 的 bean。 比 方 
说 ， 当 某 一 个 JAR 包 在 一 个 类 路 人 径 下 的 时 候 ， 会 目 
动 配置 一 个 或 多 个 bean; 或 者 只 有 某 个 bean 被 创建 
后 才 会 创建 另外 一 个 bean。 总 的 来 说 ， 就 是 根据 特 
定 条 件 来 控制 bean 的 创建 行为 ， 这 样 我 们 可 以 利用 
这 个 特性 进行 一 些 上 自动 的 配置 。 当 然 ，Conditional 
注解 有 非常 多 的 使 用 方式 ， 我 们 仅仅 通过 
ConditionalOnProperty 来 深入 探讨 它 的 运行 机 制 。 
我 们 通过 一 个 示例 来 详细 了 解 。 


更 改 示 例 中 的 内 容 ， 在 配置 类 中 增加 
ConditionalOnProperty 注 解 : 





QConfiguration 

QComponentScan(("com.spring.study.module")) 
@ConditionalOnProperty(prefix = "study", name = "enable", havin 
gValue = "true") 


public class HelloServiceAutoConfiguration { 


j 
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显示 的 声明 study.enable=true， 则 当前 的 整套 体系 才 
生效 ， 我 们 可 以 进行 验证 ， 如 图 14-9 所 示 。 


PES ML 
BIE 
oeleleleleloleloleleleiotclololokek 

Description: 


Field helloService in com.springstudy.controller.TestController required a bean of type 'com.spring.study.module.HelloService' that could not be found. 


Action: 


Consider defining a bean of type 'com.spring.study.module.HelloService' in your configuration 


Process finished with exit code 1 


图 14-9 ”studyweb 启 动 失败 


发 现 局 动 失 败 ， 而 报错 信息 则 是 注入 时 找 不 到 
对 应 的 bean， 这 说 明 Starter 中 的 bean 并 未 生效 。 当 
我 们 加 入 study.enabled=true 配 置 后 ， 如 图 14-10 所 
示 。 


E Project ~ = Ææ- l-  "$application.properties 
| studyweb ~/git/studyweb = ng. file-./spr ingboot. log 

d 3 logging.level.org E m e work.web-INFO 
idea logging. level 
src 

main 5 study.enabled=true 

Ma ja 

com 
pringstudy 
troll 


'€ TestController 
T SpringBootDemo'1Ap| 
* resources 
而 application.properties 
| !0g4j.properties 
test 


图 14-10 ”studyweb 加 入 配置 


继续 局 动 ， 友 现 局 动 成 功 ， 如 图 14-11 所 示 。 


POA 22, 2018 10:23:02 上 午 org.springframework.boot.web.servlet.FilterRegistrationBean configure 

信息 : Mapping filter: 'requestContextFilter' to: [/x] 

四 月 22, 2018 10:23:03 上 午 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter initControllerAdviceC 
信息 : Looking for @ControllerAdvice: org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext(262b2ct 
POA 22, 2018 10:23:03 上 午 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping register 

信息 : Mapped "{[/]}" onto java.lang.String com.springstudy.controller.TestController.home() 

POA 22, 2018 10:23:03 上 午 org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping register 

信息 : Mapped "{[/error]}" onto public org.springframework.http.ResponseEntity«java.util.Map«java.lang.String, java.lang.Object»» ort 
PUA 22, 2018 10:23:03 t+ org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping register 

信息 : Mapped "([/error],produces-[text/html])" onto public org.springframework.web.servlet.ModelAndView org.springframework.boot.aut 
四 月 22, 2018 10:23:03 E+ org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler 

信息 : Mapped URL path [/webjars/**] onto handler of type [class org.springframework.web.servlet,.resource.ResourceHttpRequestHandler] 
POA 22, 2018 10:23:03 上 午 org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler 

信息 : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 

四 月 22, 2018 10:23:03 上 午 org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler 

信息 : Mapped URL path [/**/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHanc 
四 月 22, 2018 10:23:03 上 午 org.springframework. jmx.export.annotation.AnnotationMBeanExporter afterSingletonsInstantiated 

信息 : Registering beans for JMX exposure on startup 

四 月 22, 2018 10:23:03 E+ org.springframework.boot.context.embedded.tomcat.TomcatEmbeddedServletContainer start 

信息 : Tomcat started on port(s): 8080 (http) 

四 月 22, 2018 10:23:03 E+ com.springstudy.SpringBootDemolApplication logStarted 

信息 : Started SpringBootDemolApplication in 1.717 seconds (JVM running for 2.117) 


图 14-11 ”studyweb 启 动 成 功 
14.5.2 Conditional/5 ££ 


好 ， 了 解 了 — g di 使 用 后 我 
们 继续 深入 探索 它 的 内 部 实现 机 制 。 继 续 按 照 之 前 
的 思路 ， 如 果 想 et inei 的 实现 
机 制 ， 那 么 在 代码 中 必然 会 存在 
ConditionalOnProperty.class 的 调用 ， 于 是 我 们 搜索 
ConditionalOnProperty.class， 如 图 14-12 所 示 。 











Find in Path Match case Words Regex ? File mask: *.java T c 
| l* ConditionalOnProperty.class 7 E 4 matches in1file € | 
In project Module Directory | Scope Project and Libraries ia 


OnPropertyCondition 56 








ConditionMessage.forCondition(Cond 


JorConditico MR spec).because("matched")); 114 


图 14-12  ConditionalOnProperty.class1£ z& £i R 


发 现 所 有 的 调用 都 出 现在 一 个 类 
OnPropertyCondition 中 ， 于 是 进入 这 个 类 ， 如 图 14- 
13 所 示 ， 好 在 其 中 仅仅 有 一 个 public 方 法 ， 这 会 大 
大 减少 我 们 的 分 析 范 围 。 


| OnPropertyCondition.java 
Inherited members (80) Anonymous Classes (%1) Lambdas (3L) e 


v OnPropertyCondition rt 


m ê annotationAttributesFromMultiValueMap(MultiValueMap<String, Object: 
m 8 determineOutcome(AnnotationAttributes, PropertyResolver): Condition! 
| etMatchOutcome(ConditionContext, AnnotatedTypeMetadata): Condit 
| ££ ? Spec 1 








图 14-13 ”ConditionalOnProperty 类 的 方法 属性 


OnPropertyCondition 类 的 getMatchOutcome 方 法 
如 下 : 





public ConditionOutcome 


getMatchOutcome(ConditionContext context, 
AnnotatedTypeMetadata metadata) { 
List«AnnotationAttributes» allAnnotationAttributes - annotat 
ionAttributesFromMulti 
ValueMap( 
metadata.getAllAnnotationAttributes( 
ConditionalOnProperty.class.getName())); 
List«ConditionMessage» noMatch - new ArrayList«ConditionMess 
age»(); 
List«ConditionMessage» match - new ArrayList«ConditionMessag 


e»(); 
for (AnnotationAttributes annotationAttributes : allAnnotati 

onAttributes) { 

ConditionOutcome outcome - determineOutcome(annotationAtt 
ributes, 

context.getEnvironment()); 

(outcome.isMatch() ? match : noMatch).add(outcome.getCond 

itionMessage()); 


if (!noMatch.isEmpty()) { 
return ConditionOutcome.noMatch(ConditionMessage.of(noMat 
ch)); 


return ConditionOutcome.match(ConditionMessage.of(match)); 


} 
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boolean 值 ， 但 是 现在 却 返 回 ConditionOutcome 这 样 
一 个 对 象 ， 这 是 什么 道理 呢 ? 我 们 看 一 下 这 个 数据 
结构 : 


public class ConditionOutcome { 








private final boolean match; 
private final ConditionMessage message; 


XXX XXX .. 


j 





这 里 面 除了 大 量 的 方法 外 有 一 个 比较 重要 的 属 
性 字段 ， 就 是 类 型 为 boolean 的 match 字 段 ， 根 据 直 
觉 ， 大 致 可 以 断定 这 个 属性 很 重要 ， 再 来 看 


ConditionOutcome.noMatch(ConditionMessage.of(noMatch)) 


MEN 
对 应 的 构造 逻辑 : 


public static ConditionOutcome noMatch(ConditionMessage message 


return new ConditionOutcome(false 


, message); 





以 及 


对 应 的 构造 逻辑 : 


public static ConditionOutcome match(ConditionMessage message) 


return new ConditionOutcome(true 


, message); 





FEA pex s EBSIAS B. JA TRISXX 
个 信息 可 以 断定 ， 中 noMatch 
这 个 属性 的 逻辑 一 整个 逻辑 的 核心 。 


我 们 重新 再 去 分 析 getMatchOutcome 隙 数 中 的 


X 18: 


List«AnnotationAttributes» allAnnotationAttributes - 
annotationAttributesFromMultiValueMap( 


metadata.getAllAnnotationAttributes(Conditiona 
10nProperty 


.class.getName()) 


); 





这 人 句 代 码 是 要 扫 摘 出 ConditionalOnProperty 的 
注解 信息 ， 例 如 我 们 刚才 配置 的 


@ConditionalOnProperty(prefix = "study", name = "enabled", havi 
ngValue = "true") 





我 们 通过 Debug 进 一 步 确认 : 


通过 上 面 的 断 点 信息 ， 我 们 可 以 看 到 name 对 应 
的 enabled 属 性 已 经 被 读 取 ， 如 图 14-14 所 示 。 那 
么 ， 现 在 核心 的 验证 逻辑 就 应 该 在 
ConditionOutcome outcome = determineOutcome 
(annotationAttributes, context.getEnvironment()) 中 


了 。 顺 看 函数 继续 进行 下 一 步 探 索 : 





@0verride 
public ConditionOutcome Loser m gie ihe context; 
AnnotatedTypeMetadata metadata) { meta 7 3 
List<AnnotationAttributes> KUDARIGERELOGACETIERUERS = annotationAtribvtesFromuttivetueyap( 311AnnotationAttributes: size = 1 

metadata.getAllAnnotationAttributes( metadata: Ar ) 4 
ConditionalOnProperty.class.getName() )); 

List<ConditionMessage> noMatch = new ArrayList«ConditionMessage»(); 
List«ConditionMessage» match = new ArrayList«ConditionMessage»(); 
for (AnnotationAttributes annotationAttributes : 
Conditionüutcome outcome = deternineQutcone(annotationAttributes, 









tes: size = 6 allAnnotationAttributes: size 





ri e e Evaluate 
Expression: 
allannotationAttributes B 
Use (3647 to add to Watches 
} Result: 
é& result = (ArrayList(23088) si 





ul 191} size = 6 

4 02) "havingValue" -» ^ 

OnPra 103) "prefix" -» "server.error.whitelabel" 
53104) "relaxedNames" -> "true" 
3105) "name" -» 

i- Ea 

| $B value = {String[1]@3115} | 
G xd 3 J$Entry@ 


y($3106) "matchlfMissing" -> "true" 
7) "value" -» 





图 14-14 ConditionalOnProperty Bc E 3k HX 





private ConditionOutcome determineOutcome(AnnotationAttributes 
annotationAttributes, 
PropertyResolver resolver) { 
Spec spec = new Spec(annotationAttributes); 
List<String> missingProperties 


= new ArrayList<String>(); 
List<String> nonMatchingProperties 


= new ArrayList<String>(); 
spec.collectProperties(resolver, missingProperties, nonMatch 
ingProperties); 


if (!missingProperties.isEmpty() 


) i 


return ConditionOutcome.noMatch( 
ConditionMessage.forCondition(ConditionalOnProperty 
.Class, spec) 
.didNotFind("property", "properties") 
.items(Style.QUOTE, missingProperties)); 
} 


if (!nonMatchingProperties.isEmpty() 


jt 
return ConditionOutcome.noMatch( 
ConditionMessage.forCondition(ConditionalOnProperty 
.Class, spec) 
.found("different value in property", 
"different value in properties") 
.items(Style.QUOTE, nonMatchingProperties)); 


return ConditionOutcome.match(ConditionMessage 


.forCondition(ConditionalOnProperty.class, spec).becau 
se("matched")); 


j 





这 个 逻辑 表明 ， 不 区 配 有 两 种 情况 : 
missingProperties 对 应 属性 缺失 的 情况 ; 
nonMtatchingProperties 对 应 不 匹配 的 情况 。 而 这 两 
个 属性 的 初始 化 都 在 spec.collectProperties (resolver, 
missingProperties, nonMatchingProperties) 中 ， 于 是 


进入 这 个 函数 : 





private void collectProperties(PropertyResolver resolver, List< 
String> missing, 
List«String» nonMatching) { 
if (this.relaxedNames) { 
resolver = new RelaxedPropertyResolver(resolver, this.pre 


fix); 
} 
for (String name : this.names) { 
String key = (this.relaxedNames ? name : this.prefix + na 
me); 
if (resolver.containsProperty(key)) (1 


if (!isMatch(resolver.getProperty(key), this.havingVal 
ue)) { 


nonMatching.add(name); 


} 
else ( 
if (!this.matchIfMissing) { 


missing.add(name); 





终于 ， 我 们 找到 了 对 应 的 逻辑 ， 这 个 函数 答 试 








使 用 PropertyResolver 来 验证 对 应 的 属性 是 否 存在 ， 

如 果 不 存 在 则 验证 不 通过 ， 因 为 PropertyResolver 中 
包含 了 所 有 的 配置 属性 信息 。 而 PropertyResolver 的 
初始 化 以 及 相关 属性 的 加 载 我 们 会 在 下 一 厄 详 细 介 


绍 。 


145.3 ”调用 切入 点 


那么 现在 的 问题 是 ，OnPropertyCondition 
getMatchOutcome 方 法 是 谁 去 调用 的 呢 ? 或 者 说 这 
个 类 是 如 何 与 Spring 整合 在 一 起 的 呢 ? 它 又 是 怎么 
样 影响 bean 的 加 载 馆 辑 的 呢 ? 我 们 再 从 全 局 的 角度 
来 梳理 下 Conditional 的 实现 逻辑 。 读 者 可 以 继续 看 
图 14-8 中 的 bean 的 parse 解 析 链 路 ， 在 3.2.1 
processConfigurationClass 步 骤 中 的 主要 尿 辑 是 要 对 


即将 解析 的 注解 做 预 处 理 ， 如 图 14-15 所 示 。 











图 14-15 ”processConfigurationClass 位 置 


图 14-15 很 清晰 地 展示 了 Spring 整 个 配置 类 解析 
及 加 载 的 全 过 程 ， 那 么 通过 分 析 代 码 定位 到 原来 整 
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processConfigurationClass 中 ， 代 码 如 下 : 





protected void processConfigurationClass(ConfigurationClass con 
figClass) throws IOException { 
if (this.conditionEvaluator.shouldSkip(configClass.getMetada 
ta(), ConfigurationPhase. 
PARSE CONFIGURATION)) { 
return; 


j 


ConfigurationClass existingClass - this.configurationClasses 
.get(configClass); 
if (existingClass !- null) ( 
if (configClass.isImported()) { 
if (existingClass.isImported()) { 
existingClass.mergelImportedBy(configClass); 
} 
// Otherwise ignore new imported config class; existin 
g non-imported class overrides it. 
return; 
} 
else ( 
// Explicit bean definition found, probably replacing 
an import. 
// Let's remove the old one and go with the new one. 
this.configurationClasses.remove(configClass); 
for (Iterator«ConfigurationClass» it - this.knownSuper 
classes.values().iterator(); it.hasNext();) { 
if (configClass.equals(it.next())) { 
it.remove(); 


} 


// Recursively process the configuration class and its super 
class hierarchy. 
SourceClass sourceClass = asSourceClass(configClass); 
do { 
sourceClass - doProcessConfigurationClass(configClass, so 
urceClass); 


j 


while (sourceClass !- null); 


this.configurationClasses.put(configClass, configClass); 


j 





AUI) S5 — 17 RE SE ConditionaDZ 48 ^E 2 If 
WAR: spicy at ina eiat ai 的 解 
析 逻 辑 ， 那 么 这 个 类 的 属性 以 及 componentScan 之 
英 的 配置 也 自然 不 会 得 到 解析 了 这 个 方法 会 拉 取 
所 有 的 condition 属 性 ，onConditionProperty 束 是 这 里 
拉 取 的 : 








public boolean shouldSkip(AnnotatedTypeMetadata metadata, Confi 
gurationPhase phase) { 
if (metadata -- null || !metadata.isAnnotated(Conditional.cl 
ass.getName( ))) { 
return false; 


i 


if (phase == null) { 
if (metadata instanceof AnnotationMetadata && 
ConfigurationClassUtils.isConfigurationCandidate((A 
nnotationMetadata) metadata)) { 
return shouldSkip(metadata, ConfigurationPhase.PARSE_C 
ONFIGURATION); 


return shouldSkip(metadata, ConfigurationPhase.REGISTER B 
EAN); 


j 


List<Condition> conditions = new ArrayList«Condition»(); 
for (String[] conditionClasses : getConditionClasses 


(metadata)) { 
for (String conditionClass : conditionClasses) ( 
Condition condition - getCondition(conditionClass, thi 
s.context.getClassLoader()); 
conditions.add(condition); 


j 
j 


AnnotationAwareOrderComparator.sort(conditions); 


for (Condition condition : conditions) { 
ConfigurationPhase requiredPhase - null; 
if (condition instanceof ConfigurationCondition) { 
requiredPhase = ((ConfigurationCondition) condition).g 


etConfigurationPhase(); 


} 
if (requiredPhase == null || requiredPhase == phase) { 
if (!condition.matches(this.context, metadata) 
)4 
return true; 
} 
} 
} 
return false; 
} 





这 段 方 法 里 面 有 几 个 关键 的 地 方 。 


e。Ccondition 的 获取 。 


通过 代码 getConditionClasses(metadata) 调 用 ， 
因为 代码 走 到 这 里 aie TE AS 的 解析 ， 
metadata 中 包含 了 完整 的 配置 类 信息 ， 只 要 通过 
metadata.getAll AnnotationAttributes 
(Conditional.class.getName(), true) 即 可 获取 ， 所 以 这 
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e condition piz 17 Vl Ad. 


通过 代码 condition.matches(this.context， 
metadata) 调 用 ， 因 为 我 们 的 配置 为 @ConditionalOn 
Property(prefix = "study", name = "enabled", 
havingValue = "true") 


所 以 此 时 condition 对 应 的 运行 态 类 为 
OnPropertyCondition, 1 fF WtFR14 5.27 HWA 45 
合 起 来 了 。 


14.6 ”属性 目 动 化 配置 实现 


14.6.1 示例 


通过 14.5.2 市 的 介绍 ， 我 们 了 解 到 对 于 下 述 注 
解 ，Spring Boot 会 读 取 配置 拼装 成 study.enabled 并 
作为 key， 然 后 尝试 使 用 PropertyResolver 来 验证 对 
应 的 属性 是 售 存 在 ， 如 采 不 存在 则 验证 不 通过 ， 目 
然 也 吏 不 会 继续 后 面 的 解析 流程 ， 因 为 
PropertyResolver 中 包含 了 所 有 的 配置 属性 信息 。 








@ConditionalOnProperty(prefix = "study", name = "enabled", havi 


ngValue = "true") 








JA, PropertyResolver 又 是 如 何 被 初始 化 的 
We? 同样 ， 这 一 功能 并 不 仅仅 供 Spring 内 部 使 用 ， 
在 现在 的 Spring 中 我 们 也 可 以 通过 Value 注解 直接 将 
属性 赋值 给 类 的 变量 。 这 两 个 问题 都 涉及 Spring 的 
属性 处 理 逻 辑 。 我 们 在 研究 它 的 属性 处 理 逻 辑 前 先 
体验 一 下 通过 Value 注 解 注 入 属性 的 样 例 。 











@Component 
public class HelloServicelmpl implements HelloService { 


@Value("${study.testStr}") 


private String testStr; 
public String sayHello(){ 


return "hello!! "+testStr; 


public String getTestStr() ( 
return testStr; 


public HelloServiceImpl setTestStr(String testStr) { 
this.testStr = testStr; 
return this; 


j 





在 studyweb 中 的 application.properties 加 入 
study.testStr=this is testStr， 如 图 14-16 所 示 。 


| Project ~ = æ- l- %G application.properties 
= Studyweb -/git/studyweb sai ng.fi i d. spri ingboot. log 
.idea logging. lev ph pot ni idi amework web-INFO 
c logging. ud. .com NFO 
mai 
M ja 





'€ TestController 
eum ingBootDemo'1Applicatio 


pmi — 
:log4j.propertie: 


414-16 ”属性 配置 


运行 后 显示 了 我 们 配置 的 结果 的 属性 ， 证 明 属 
性 生效 ， 结 果 如 图 14-17 所 示 。 


| 











£ C © localhost:8080 


hello!! this is testStr 
| 


图 14-17 属性 生效 验证 
14.6.2 ”原理 


同样 ， 要 探索 它 的 实现 原理 ， 按 照 之 前 的 思 
路 ， 我 们 痛 先 定位 关键 字 然 后 反 推 代码 逻辑 。 我 们 
通过 搜索 Value.class 进 行 反 推 ， 如 图 14-18 所 示 。 


Find in Path Match case Words Regex ? File mask: *.java y. * 
e 四 


* Value.class 


InProject Module Directory Scope Project and Libraries sis 





private Class<? extends Annotation» valueAnnotationType = Ve C SSH 
this.autowiredAnnotationTypes.add(Value.class); 
/* Value class used to enclose information 





QualifierAnnotationAutowireCandidateResolver 63 


/* Value class used to enclose information 
setValue(classes); 

Object value = getClassSpecificValue(classKey); 

UnwrapValidatedValue unwrapValidatedValue = field.getAnnotation( UnwrapValidatedValue.class ); 


图 14-18 ”Value.class 搜 索 结 


找到 了 一 个 看 起 来 像 是 调用 点 的 地 方 ， 进 入 
QualifierAnnotationAutowireCandidateResolver 这 个 


KRAANI: 





private Class<? extends Annotation> valueAnnotationType = Value 


.class; 








这 是 一 个 属性 定义 ， 那 么 进一步 查看 使 用 这 个 
属性 的 地 方 : 


protected Object findValue(Annotation[] annotationsToSearch) { 
AnnotationAttributes attr - AnnotatedElementUtils.getMergedA 


nnotationAttributes( 
AnnotatedElementUtils.forAnnotations(annotationsToSear 


ch), this.valueAnnotationType 


); 


if (attr != null) { 
return extractValue(attr); 


return null; 


j 








然后 我 们 设置 断 点 来 看 一 看 系统 在 局 动 的 时 候 
旦 人 否 在 此 保留 ， 进 而 验证 我 们 的 判断 ， 如 图 14-19 
Bae 


protected Object findValue(Am notation[] a ToSearch) 1 Ann 
tionAttributes attr Bees ctated ln entutits -gethergedum notada di ibute 5 


10424 
AnnotatedElementUtils.forAnn ns(an nsToSearch) , is. one) ; annotations] 
r !- null) 1 
ractValue(attr); 





ult: 
& result = "$(study.testStr)" 
*f value = (char[16]@4853} 


hash =0 


图 14-19 Valuey fif Ab FHA 3835 


RIK, BRIS 到 行 代码 后 程序 在 断 反 处 保住 ， 而 
== evaluate lit XbA Wik Ja Be Bi Je ER 
IIE Go Value($ (study.testStrY "P REB KIE. 为 属 
所 以 获取 注解 中 的 属性 就 比较 徐 
WT. 





protected Object extractValue(AnnotationAttributes attr) { 
Object value - attr.get(AnnotationUtils.VALUE); 
if (value -- null) ( 
throw new IllegalStateException("Value annotation must ha 
ve a value attribute"); 


return value; 





现在 要 解决 两 个 疑问 。 


。 表 达 式 对 应 的 值 是 在 哪里 被 瞧 换 的 ? 
。 表 达 式 丛 换 后 的 值 义 是 如 何 与 原 有 的 bean 整 合 
的 ? 


带 着 这 两 个 疑问 ， 我 们 顺 着 调用 栈 继 续 找 线 
索 ， 发 现 当 获 取 到 Value 的 表达 式 属 性 后 程序 进入 
J DefaultListableBeanFactory 类 的 
resolveEmbeddedValue 方 法 ， 并 且 在 尝试 evaluate 后 
发 现 返 回 的 值 正 是 属性 蔡 换 后 的 值 ， 如 图 14-20 所 
ZN o 


public dion EA. Res oiy m A en ne pen ndencyDescriptor descriptor, String beanName, 
ing> Tn ter typeConverter) throws n 
InjectionPoint previousInjectionPoint = ConstructorResolver.setCurrentInjectionPoint(descriptor); previ Inject ] 


ject shortcut = descriptor.reso 
if (shortcut v arty { 
return sho ; shortcut: null 


Class<?> type = descriptor.ge bri nden Ber ts String 
Object ate der towireCandidateResolver().ge cina tedValu aides riptor)s value: "$(study.testStr)" descriptor: "field 'tes 
if (v 1 

i eof Stri 





ssion: 
1 resolveEmbeddedValue((String) value) a 
e to Watches | 
| Result: E * 
| Wresu{=sthisistestsu= 1) F- 
49 value = {char[15]@4862} E. 
iP hash - 0 


| 
t 


14-20 ”表达 式 evaluate 结 果 
么 现在 问题 就 比较 清晰 了 ， 蔡 换 的 逻辑 一 


是 在 resolveEmbeddedValue 方 法 中 : 


@Override 
public String resolveEmbeddedValue(String value) { 
if (value == null) { 
return null; 
} 
String result = value; 
for (StringValueResolver resolver : this.embeddedValueResolv 
ers) { 
result = resolver.resolveStringValue(result ) 


if (result == null) { 
return null; 


j 


return result; 


j 





通过 代码 逻辑 我 们 看 到 ， 对 于 属性 的 解析 已 经 
委托 给 了 StringValueResolver 对 应 的 实现 类 ， 接 下 
来 我 们 就 要 分 析 一 下 这 个 StringValueResolver 是 如 
何 初始 化 的 。 


StringValueResolver 功 能 实现 依赖 Spring 的 切入 
点 是 PropertySourcesPlaceholderConfigurer， 我 们 看 
一 下 它 的 依赖 结构 。 如 图 14-21 所 示 ， 它 的 关键 是 
实现 了 BeanFactoryPostProcessor 接 口 ， 从 而 利用 实 
现 对 外 扩展 函数 postProcessBeanFactory 来 进行 对 
Spring 的 扩展 。 








® © Ordered 


© * PropertiesLoaderSupport | ® © Aware 


1 ! 
© > PropertyResourceConfigurer "t © BeanNameAware | ® > BeanFactoryAware ® © Environmen tAware 
A A 


® > PriorityOrdered | "t BeanFactoryPostProcessor 
à à 




















[] 1 
1 1 
© © PlaceholderConfigurerSupport 





1 
1 
'€ * PropertySourcesPlaceholderConfigurer 





图 14-21 PropertySourcesPlaceholderConfigurer£i fj 


Ak 53H 13.56] postProcessBeanFactory FK ZI A. HO ff] 
4] BT2K YE T fif String ValueResolvert/ a(t Hy 43x 
Fe. WuÉ14-22BTz. I HAE FASEB 
PropertySourcesPlaceholderConfigurer2S ff] 
postProcessBeanFactory FK ZA fF. A A H o 








图 14-22 StringValueResolver 9] t 433: FE 
1. 初始 化 MutablePropertySources 


首先 会 通过 this. environment 来 初始 化 
MutablePropertySources. 1X FIA JL ra Ze ji AH, 
environment 是 Spring 属 性 加 载 的 基础 ， 里 面包 含 了 
Spring 己 经 加 载 的 各 个 属性 ， 而 之 所 以 使 用 
MutablePropertySources# 2, ÆA A 
MutablePropertySources 还 能 实现 单独 加 载 自 定义 的 
额外 属性 的 功能 。 





2. ]45 4 PropertySourcesPropertyResolver 


45: HH PropertySourcesPropertyResolverXj 
MnutablePropertySources 的 操作 进行 进一步 封装 ， 使 
得 操作 多 个 文件 属性 对 外 部 不 感知 。 当 然 
PropertySourcesPropertyResolver 还 提供 一 个 重要 的 
功能 就 是 对 变量 的 解析 ， 例 如 ， 它 的 初始 化 过 程 会 
包含 这 样 的 设置 : 








propertyResolver.setPlaceholderPrefix(this.placeholderPrefix); 
propertyResolver.setPlaceholderSuffix(this.placeholderSuffix); 


propertyResolver.setValueSeparator(this.valueSeparator); 








而 对 应 的 变量 定义 如 下 : 


public static final String DEFAULT PLACEHOLDER PREFIX 
public static final String DEFAULT PLACEHOLDER SUFFIX 
public static final String DEFAULT VALUE SEPARATOR = ":"; 


"${"; 


" "n, 
了 





3. StringValueResolver 9] 45 (4 


StringValueResolver 存 在 的 目的 主要 是 对 解析 
逻辑 的 进一步 封 狼 ， 例 如 通过 变量 ignore 
UnresolvablePlaceholders 来 控制 是 否 对 变量 做 解 
析 ， 它 的 初始 化 代码 如 下 : 





StringValueResolver valueResolver = new StringValueResolver() { 
@Override 
public String resolveStringValue(String strVal) { 
String resolved - (ignoreUnresolvablePlaceholders ? 
propertyResolver.resolvePlaceholders(strVal) : 
propertyResolver.resolveRequiredPlaceholders(strVal 


if (trimValues) { 
resolved - resolved.trim(); 


return (resolved.equals(nullValue) ? null : resolved); 





在 上 面 的 代码 中 resolvePlaceholders 表 示 如 果 变 
量 无 法 解析 则 忽略 ，resolveRequired Placeholders 表 
示 如 条 变 量 无 法 解析 则 抛 异 名。 


4. StringValueResolver 注 册 


最 后 将 StringValueResolver 实 例 注 册 到 单 例 
ConfigurableListableBeanFactory 中 ， 也 就 是 在 真正 
解析 变量 时 使 用 的 StringValueResolver 实 例 。 


这 里 耐 有 一 个 关键 点 ， 就 是 在 初始 化 
MutablePropertySources 的 时 候 依 赖 的 一 个 变量 
environment。Environment 是 Spring 所 有 配置 文件 转 
换 为 KV 的 基础 ， 而 后 续 的 一 系列 操作 都 是 在 
environment 基 础 上 做 的 进一步 封闭， 那么 我 们 就 再 
来 探索 一 下 environment 的 实现 路 径 ， 如 图 14-23 所 
示 。 











ConfigFileApplicationListener ConfigFileApplicationListener ConfigFileApplicationListener.Loader ConfigurableEnvironment 





. addConf igurationProperties 


图 14-23 environment ?] 45 14 Fe 


HH 414-2348) 4, environment] 45 A, xx FEIF A 
是 之 前 通用 的 在 PostProcessor 类 型 的 扩展 口上 做 扩 
展 ， 而 是 通过 ConfigFileApplicationListener 监 听 机 





制 完 成 。 当 然 这 里 面 要 重点 提 到 步骤 4 load 方 法 ， 


IT 
它 是 整个 流程 的 核心 反 : 





public void load() { 
this.propertiesLoader = new PropertySourcesLoader(); 
this.activatedProfiles = false; 
this.profiles = Collections.asLifoQueue(new LinkedList«Profi 
le>()); 
this.processedProfiles = new LinkedList«Profile»(); 





// 通过 profile 标 记 不 同 的 环境 ， 可 以 通过 设置 spring.profiles.active 和 sp 
ring.profiles.default。// 如 果 设 置 了 active，default 便 失去 了 作用 。 如 果 
两 个 都 没有 设 // 置 ， 那 么 带 有 profiles 的 bean 都 不 会 生成 。 

Set<Profile> initialActiveProfiles = initializeActiveProfile 
s(); 
this.profiles.addAll(getUnprocessedActiveProfiles(initialAct 
iveProfiles)); 
if (this.profiles.isEmpty()) { 
for (String defaultProfileName : this.environment.getDefa 
ultProfiles()) ( 
Profile defaultProfile - new Profile(defaultProfileNam 
e, true); 
if (!this.profiles.contains(defaultProfile)) { 
this.profiles.add(defaultProfile); 











j 
j 


// 支 持 不 添加 任何 profile 注 解 的 bean 的 加 载 
this.profiles.add(null); 





while (!this.profiles.isEmpty()) (1 
Profile profile - this.profiles.poll(); 





//Spring Boot 默认 从 4 个 位 置 查找 application.properties 文 件 就 是 从 getSe 
archLocations( ) 方 法 返回 : 





//1. 当前 目录 下 的 /config 目 录 
//2. 当前 目录 

//3. 类 路 径 下 的 /config 目 录 
//4. 类 路 径 根 目录 


for (String location : getSearchLocations() 


if (!location.endsWith("/")) ( 
// location is a filename already, so don't search 


// filenames 
load(location, null, profile); 


else ( 
// 如 果 没 有 配置 则 默认 从 application.properties 中 加 载 ， 约 定 大 于 配置 
for (String name : getSearchNames() 






































load(location, name, profile); 


this.processedProfiles.add(profile); 


j 


addConfigurationProperties(this.propertiesLoader.getProperty 
Sources()); 


j 





这 里 面 涉及 我 们 经 常 使 用 的 profile 机 制 的 实 





现 ，profile 机 制 是 Spring 提供 的 一 个 用 来 标明 当前 
运行 环境 的 注解 。 我 们 在 正常 开发 的 过 程 中 经 党 遇 
到 这 样 的 问题 ， 开 发 环境 是 一 僚 环境 ，QA 测 试 是 
一 僚 环 境 ， 线 上 部 晋 又 是 一 套 环境 。 从 开发 到 测试 
再 到 部 署 ， 会 对 程序 中 的 配置 修改 多 次 ， 尤 其 是 从 
QA 到 上 线 这 个 环节 ， 经 过 QA 测试 的 也 不 敢 保 证 改 
了 哪个 配置 之 后 能 不 能 在 线 上 运行 。 


为 了 解决 上 面 的 问题 ， 我 们 一 般 会 使 用 一 种 方 














法 一 一 配置 文件 ， 然 后 通过 不 同 的 环境 读 取 不 同 的 
配置 文件 ， 从 而 在 不 同 的 场景 中 运行 我 们 的 程序 。 


Spring 中 的 profile 机 制 的 作用 束 体 现在 这 里 。 
在 Spring 使 用 DI 来 依赖 注入 的 时 候 ， 能 够 根据 当前 
制定 的 运行 环境 来 注入 相应 的 bean。 最 第 见 的 束 是 
使 用 不 同 的 环境 对 应 不 同 的 数据 源 。 


这 个 机 制 的 实现 束 是 在 load(location, name, 
profile) 这 段 代 码 中 控制 ， 这 里 只 会 加 载 当前 设置 
profile 对 应 的 配置 文件 。 














14.7 ”Tomcat 启动 


截止 到 目前 ， 我 们 已 经 完成 了 对 Spring Boot 基 
本 功能 的 分 析 ， 包 括 Spring Boot 的 启动 、 属 性 自动 
化 配置 、conditional 实 现 以 及 starter 运 行 模式 原理 。 
那么 ， 在 之 前 的 理论 基础 上 再 来 分 析 Spring Boot 是 
如 何 集 成 Tomcat 会 更 为 简单 。 


分 析 Tomcat 舱 入 原理 首先 要 找到 扩展 入 口 ， 我 
们 可 以 从 局 动 信息 开始 ， 如 图 14-24 所 示 。 








nto public org.springframework.http.ResponseEntity<java.util.Map<java.lang.String, java. lang. 
org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping register 

»duces-[text/html])" onto public org.springframework.web.servlet.ModelAndView org.springframew 
org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler 

djars/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpReq 
org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler 

| onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHand 
org.springframework.web.servlet.handler.SimpleUrlHandlerMapping registerHandler 

/favicon.ico] onto handler of type [class org.springframework.web.servlet.resource.ResourceHtt 
org.springframework.jmx.export.annotation.AnnotationMBeanExporter afterSingletonsInstantiatec 

r JMX exposure on startup 
org. springframework.boot.context.embedded.tomcat. start 

rt(s): 8080 (http) 


14-24 Tomcat 启 动 信息 


当然 ， 为 了 整个 说 明 的 连贯 性 我 们 还 是 从 入 口 
处 讲 起 。 在 讲解 14.3.1 springContext 创 建 的 时 候 我 
们 曾经 提 到 过 一 段 代 码 : 





protected ConfigurableApplicationContext createApplicationConte 
xt() 1 
Class<?> contextClass = this.applicationContextClass; 
if (contextClass -- null) ( 
try { 
contextClass = Class.forName(this.webEnvironment 
? DEFAULT_WEB_CONTEXT_CLASS : DEFAULT_CONTEXT_CL 


ASS 
); 
catch (ClassNotFoundException ex) { 
throw new IllegalStateException( 
"Unable create a default ApplicationContext, " 
* "please specify an ApplicationContextCla 
ss", 
ex); 
j 
j 


return (ConfigurableApplicationContext) BeanUtils.instantiat 
e(contextClass); 


j 





Ap. PaaS eek BUB: 


public static final String DEFAULT WEB CONTEXT CLASS 


- "org.springframework." 


* "boot.context.embedded.AnnotationConfigEmbeddedWebAppli 
cationContext"; 





这 也 是 Web 扩展 的 关键 。 在 第 5 草 我 们 曾经 花 
了 很 大 的 篇 幅 讲解 了 AbstractApplicationContext 的 一 
个 函数 refresh()， 它 是 springcontext 扩 展 的 关键 ， 再 
次 来 回顾 一 下 : 





public void refresh() throws BeansException, IllegalStateExcept 
ion ( 


synchronized (this.startupShutdownMonitor) { 
/ ERG Wall BAY E P SCA BE 


prepareRefresh(); 


// Tell the subclass to refresh the internal bean 
factory. 

// 初 始 化 BeanFactory， 并 进行 XML 文件 读 取 

ConfigurableListableBeanFactory beanFactory = obta 
inFreshBeanFactory(); 


// Prepare the bean factory for use in this contex 


// 对 BeanFactory 进 行 各 种 功能 填充 
prepareBeanFactory(beanFactory); 


try { 
// Allows post-processing of the bean factory 

in context subclasses. 
// 子 类 覆盖 方法 做 额外 的 处 理 


postProcessBeanFactory(beanFactory); 























调用 是 在 getBean 时 候 

















化 处 到 





H 


xt. 


ticaster"bean'H 


context subclasse 


广播 器 中 





ingletons. 





r 刷 新 过 程 ， 同 时 发 出 


catc 


dangling resourc 














// 激 活 各 种 BeanFactory 处 理 器 
invokeBeanFactoryPostProcessors(beanFactory); 























// 注册 拦截 Bean 创 建 的 Bean 处 理 器 , 这 里 只 是 注册 ， 真 正 的 








registerBeanPostProcessors(beanFactory); 

// 为 上 下 文 初始 化 Message 源 ， 即 不 同 语言 的 消息 体 ， 国 际 
initMessageSource(); 

// Initialize event multicaster for this conte 


// 初始 化 应 用 消息 广播 器 ， 并 放 入 “applicationEventMul 





initApplicationEventMulticaster(); 


// Initialize other special beans in specific 
S. 

// 留 给 子 类 来 初始 化 其 他 的 Bean 

onRefresh(); 





// Check for listener beans and register them. 
// 在 所 有 注册 的 bean 中 查找 Listener bean， 注 册 到 消息 





registerListeners(); 
// Instantiate all remaining (non-lazy-init) s 


// 初始 化 剩 下 的 单 实例 〈 非 惰性 的 ) 


finishBeanFactoryInitialization(beanFactory); 





// Last step: publish corresponding event. 
// Sá TERE, TEAL tin Jad PFs 1 fecycleProcesso 




















//ContextRefreshEvent38 #1 Hl A 
finishRefresh(); 


h (BeansException ex) { 
// Destroy already created singletons to avoid 
es. 


destroyBeans(); 


// Reset 'active' flag. 
cancelRefresh(ex); 


// Propagate exception to caller. 
throw ex; 





而 刚才 说 的 
AnnotationConfigEmbeddedWebApplicationContext 
正 是 扩展 了 这 个 类 ， 我 们 看 一 下 
AnnotationConfigEmbeddedWebApplicationContext 





类 的 层次 结构 ， 如 图 14-25 所 示 。 


$ © ConfigurabieWecAppicationContext. € - AbstractApplicationContext t ® © BeanDefinitionRegistry 
4 


414-25 AnnotationConfigEmbeddedWebA pplicationContext2s 
的 层次 结构 


而 EmbeddedWebApplicationContext 类 对 于 


Tomcat A BS] — ^ BE it 2 onRefresh( K ACA) BE 


@Override 
protected void onRefresh() { 
super.onRefresh(); 
try { 
createEmbeddedServletContainer(); 


catch (Throwable ex) { 
throw new ApplicationContextException("Unable to start em 
bedded container", 


ex); 
} 


} 
createEmbeddedServletContainer ( ) 函 数 对 应 代码 : 
private void createEmbeddedServletContainer() { 
EmbeddedServletContainer localContainer - this.embeddedServl 
etContainer; 
ServletContext localServletContext - getServletContext(); 
if (localContainer == null && localServletContext == null) { 
EmbeddedServletContainerFactory containerFactory - getEmb 
eddedServletContainerFactory(); 


this.embeddedServletContainer - containerFactory 
.getEmbeddedServletContainer(getSelfiInitializer()); 


else if (localServletContext != null) { 
try { 
getSelfInitializer().onStartup(localServletContext); 


catch (ServletException ex) { 


throw new ApplicationContextException("Cannot initiali 
ze servlet context", 


ex); 
} 
} 


initPropertySources(); 





EmbeddedServletContainerFactory 是 服务 器 启动 
的 上 层 抽 象 ， 无 论 是 Tomcat 还 是 Jetty 都 要 通过 这 个 
类 实现 对 Spring 服务 咒 的 注册 。 现 在 我 们 通过 上 断 点 
来 看 看 它 的 返回 结果 ， 如 图 14-26 所 示 。 











iC} EmbeddedWebApplicationContext.java €, TomcatEmbeddedServletContainerFactory.java G EmbeddedServietContainerAutoC 
而 ConditionalOnClass.java A SpringBootDemotApplication.java €, AbstractBeanFactory java ‘© Springs 
on (©) PropertySourcesPlaceholderConfigurer.java 网 ConfigFileApplicationListener.java ©, AbstractApplication 
Cc j . 
F irns the {@link EmbeddedServletContainerFactory) that should be used to create 
bedded servlet container. By default this method 
@return a {@Link EmbeddedServletContainerFactory) (never {@code null)) 
protected EmbeddedServletContainerFactory getEmbeddedServletContainerFactory() { 
20 Use bean names so that we don't consider the hierarchy 
getBeanFactory() 
sForType(EmbeddedServ let 
f (be . Length 
throw new ApplicationContextException( 
"Unable to start EmbeddedWebApplicationContext due to missing " 
liz € e Evaluate 
Expression: 
F getBeanFactory()= .getBeanNamesForType(EmbeddedServletContainerFactory.class) . 
Use 2% to add to Watches 
Result: 
& result = {String[1]@4385} 
= 0 = "tomcatEmbeddedServletContainerFactory" 
?PI 


图 14-26 getEmbeddedServletContainerFactory()i& [Hl £5 R 





正如 我 们 所 料 ， 它 返回 的 就 是 Tomcat 对 应 的 子 
类 实现 。 于 是 我 们 找到 TomcatEmbedded 
ServletContainerFactory 来 查看 它 的 实现 逻辑 ， 但 是 
却 发 现 这 个 类 既 没 有 打 一 些 Spring 注 册 的 注解 也 没 
有 配置 在 任何 配置 文件 中 ， 那 么 它 是 如 何 注入 到 
Spring 容 需 中 的 呢 ? 


市 痢 这 个 疑问 ， 我 们 搜索 代码 ， 看 一 看 是 合 会 
有 其 他 地 方 对 这 个 类 进行 了 便 编 码 的 注册 ， 如 图 








14-27 所 示 。 


Find in Path Match case Words Regex ? File mask: *.java y. > 
~ TomcatEmbeddedServietContainerFactory 3 tches in 10 files @ 
InProject Module Directory Scope Project and Libraries m 
* {@link TomcatEmbeddedServletContainerFactory) (unless you have defined your own 
import org.springframework.boot.context.embedded.tomcat. TomcatEmbeddedServietContainerFactory; 





TJ (4 TomcatembeddedServietContainerFactoryacuie sue Ee Mee luca net EmbeddedServietContainerAutoConfiguration.java 78 
return new TomcatEmbeddedServietContainerFactory(); 
import org.springframework.boot.context.embedded.tomcat. TomcatEmbeddedServietContainerFactory; 
if (container instanceof TomcatEmbeddedServietContainerFactory) { 
(TomcatEmbeddedServletContainerFactory) container); 
TomcatEmbeddedServletContainerFactory factory) ( 





/Users/haojia/.m2/repository /org/springframework/boot/spring-boot-autoconfigure/1.5.9. RELEASE/spring-boot-autoconfigure-1.5.9.RELEASE-sources.jar!/org/springframework/boot/autoconfigure/wet 


GAutoConf igureOrder(Ordered.HIGHEST PRECEDENCE) 
@Configuration 

@ConditionalOnwebApplication 
GImport(BeanPostProcessorsRegistrar.class) 

public class EmbeddedServletContainerAutoConfiguration { 


@Configuration 
@ConditionalOnClass({ Servlet.class, Tomcat.class }) 
@ConditionalOnMissingBean(value = EmbeddedServletContainerFactory.class, search = SearchStrategy. CURRENT) 


muhlie etatis relace FmhoddodTamrat { 


图 14-27 TomcatEmbeddedServletContainerFactory/# Z& 44 


EmbeddedServletContainerAutoConfigurationix 4" Z5 
进行 了 调用 ， 这 是 Spring 自 动 化 整合 各 种 服务 器 注 
册 的 非常 天 键 的 入 口 类 : 





QAutoConfigureOrder(Ordered.HIGHEST PRECEDENCE) 
QConfiguration 

@ConditionalOnWebApplication 
QImport(BeanPostProcessorsRegistrar.class) 

public class EmbeddedServletContainerAutoConfiguration { 


/** 
* Nested configuration if Tomcat 


is being used. 
*/ 
QConfiguration 
@ConditionalOnClass({ Servlet.class, Tomcat.class }) 


QConditionalOnMissingBean(value - EmbeddedServletContainerFa 
ctory.class, search - 
SearchStrategy.CURRENT ) 

public static class EmbeddedTomcat { 


@Bean 
public TomcatEmbeddedServletContainerFactory tomcatEmbedd 
edServletContainerFactory() { 
return new TomcatEmbeddedServletContainerFactory(); 


j 


j 


Jo 
* Nested configuration if Jetty 


is being used. 
"y 

QConfiguration 

@ConditionalOnClass({ Servlet.class, Server.class, Loader.cl 
ass, 

WebAppContext.class }) 

@ConditionalOnMissingBean(value = EmbeddedServletContainerFa 
ctory.class, search = 
SearchStrategy.CURRENT ) 

public static class EmbeddedJetty { 


@Bean 
public JettyEmbeddedServletContainerFactory jettyEmbedded 
ServletContainerFactory() { 
return new JettyEmbeddedServletContainerFactory(); 


j 


j 


JEF 
* Nested configuration if Undertow 


is being used. 
*/ 
@Configuration 
@ConditionalOnClass({ Servlet.class, Undertow.class, SslClie 
ntAuthMode.class }) 
@ConditionalOnMissingBean(value = EmbeddedServletContainerFa 
ctory.class, search = 


SearchStrategy.CURRENT ) 
public static class EmbeddedUndertow { 


@Bean 
public UndertowEmbeddedServletContainerFactory undertowEm 
beddedServletContainer 
Factory() { 
return new UndertowEmbeddedServletContainerFactory(); 


XXX XXX 忽略 XXX XXX 


j 
j 
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闫 型 的 服务 器 自动 注册 逻辑 ， 而 选择 条 件 则 是 通过 
@ConditionalOnClass 注 解 控 制 。 我 们 之 前 讲解 过 
ConditionalOnProperty?E f B] 33432 48, Tf 
@ConditionalOnClass 实 现 逻 辑 与 之 类 似 ， 对 应 的 类 
在 classpath 目 录 下 和 存在 时 ， 才 会 去 解析 对 应 的 配置 
文件 。 这 也 就 解释 了 之 所 以 Spring 默 认 会 局 动 
Tomcat 正 是 由 于 在 局 动 的 类 目录 下 存在 
Servlet.class、Tomcat.class， 而 这 个 依赖 是 由 Spring 
自己 在 spring-boot-starter-web 中 默认 引入 ， 如 图 14- 
28 所 示 。 








| studyweb | /;; pom.xml 











& Project ~ = | %- I= MM study-web 
Z studyweb ~/git/studyweb Refresh 

-idea : 
src Conflicts Q~ tomcat 

Ss target o All Dependencies as List Show Groupld 1 
springboot.log.O.Ick | 

astudyweb.iml All Dependencies as Tree 

= springboot.log.0 - = = 
sprinaboot.log.0.1 tomcat-annotations-api : 8.5.23 1.5.9.RELEASE [compile] | 
i ; 9 bed tomcat-embed-core : 8.5.23 spring-boot-starter-web : 1.5.9.RELEASE [comp | ! 
springboot.log.1 
te oot tomcat-embed-el : 8.5.23 

- 1 . jt. 
r : : : tomcat-embed-websocket : 8.5.23 

& springboot.log.2 P 

; spring-boot-starter-tomcat : 1.5.9.RELEASE 

到 springboot.log.2.1 

= springboot.log.3 

= springboot.log.3.1 

& springboot.log.4 

= springboot.log.4.1 

& springboot.log.5 
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按照 代码 逻辑 ， 如 采 我 们 默认 的 服务 器 不 硕 望 
使 用 Tomcat 而 是 希望 使 用 Jetty， 那 么 我 们 只 需要 将 
Tomcat 对 应 的 jar 从 spring-boot-starter-web 中 排除 
fü. FAI A Jetty ee BY n] . 





TomcatEmbeddedServletContainerFactory28 f 
getEmbeddedServletContainer()S< 22840 F, Tomcat 
4x £ getT omcatEmbeddedServletContainer(tomcat){t 
码 中 开 步 局 动 。 





QOverride 
public EmbeddedServletContainer getEmbeddedServletContainer( 
ServletContextInitializer... initializers) { 
Tomcat tomcat - new Tomcat(); 
File baseDir - (this.baseDirectory !- null ? this.baseDirect 


ory 
: createTempDir("tomcat")); 
tomcat.setBaseDir(baseDir.getAbsolutePath()); 
Connector connector - new Connector(this.protocol); 
tomcat.getService().addConnector(connector); 
customizeConnector (connector); 
tomcat.setConnector(connector); 


tomcat.getHost().setAutoDeploy(false); 
configureEngine(tomcat.getEngine()); 
for (Connector additionalConnector : this.additionalTomcatCo 
nnectors) ( 
tomcat.getService().addConnector(additionalConnector); 


j 


prepareContext(tomcat.getHost(), initializers); 
// 异 步 启动 Tomcat 
return getTomcatEmbeddedServletContainer(tomcat); 





